Ramsisa icon

Ramsisa

Generate and manage Ramsisa field visit schedules.

Actions4

Generate Schedule

AI-generated

Summary

Generate a Ramsisa schedule based on provided locations and month, optionally with webhook URL and additional fields.

Inputs

  • locations (required) — Array of location objects. Each item: { ID, name, tier (A|B|C), territory, latitude, longitude, available_from?, available_to?, available_days? }. See https://schedule.ramsisa.com/docs/api-reference/ for full field details.
  • month (required) — Target month in YYYY-MM format. Working days (Sat-Wed) are auto-computed.
  • webhookUrl — Optional URL Ramsisa will POST to when the schedule completes or fails. Use the Production URL from a Ramsisa Trigger node downstream.
  • additionalFields — Collection of optional parameters such as visits_completed, monthly_target, period_target, excluded_days.

Output shape

JSON object representing the newly created schedule (includes at least schedule_id and status)

The operation returns a single record; the exact fields depend on the Ramsisa API response, typically containing schedule_id and status information.

Examples

Example 1: Generate a schedule for June 2026 with three locations

locations: [{ID:1,name:'Site A',tier:'A',territory:'X',latitude:0,longitude:0}, {ID:2,name:'Site B',tier:'B',territory:'Y',latitude:1,longitude:1}], month: "2026-06"

Example 2: Generate schedule and receive webhook on completion

locations: [{…}], month: "2026-07", webhookUrl: "https://my-n8n.example.com/webhook/ramsisa"

Example 3: Generate schedule with custom monthly and period targets

locations: [{…}], month: "2026-08", additionalFields: {monthly_target: {"A":4,"B":2,"C":1}, period_target: {"A":2,"B":1,"C":1}}

Links

Discussion