Contractors
Invoice Schedules

Updates Contractor Invoice Schedule

Changed on

Updates a contractor invoice schedule record

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page. See Authorization for customers.

Scopes

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage invoices (invoices)-Manage invoices (invoices:write)
patch/v1/contractor-invoice-schedules/{id}

Request

  • Base URL: https://gateway.remote.com
  • URL: https://gateway.remote.com/v1/contractor-invoice-schedules/{id}
  • Auth: HTTP bearer and OAuth 2 (authorization code, authorization URL /auth/oauth2/authorize, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/company.manage, invoices:write, invoices, all:write)

Path parameters

idstring uuid required

A unique identifier in UUID v4 format.

Example:663e0b79-c893-45ff-a1b2-f6dcabc098b5

Resource unique identifier

Request body

currencystring nullable

Currency code of the SWIFT fee. Only present when processing_fee is set.

custom_daysinteger[] nullable

The two calendar days of the month on which invoices are generated. Only applies when periodicity is semi_monthly; must be omitted (or null) for every other periodicity.

When omitted for a semi_monthly schedule, the two days are derived from start_date: the start day and the day 14 days apart from it. Supply this field only to pick a cycle other than that default.

One of the two days must be the day of start_date, the days must be distinct, and they cannot resolve to the same day within a month.

notestring nullable

Custom defined note.

nr_occurrencesinteger nullable

Count of remaining invoices that should be generated.

numberstring nullable

Invoice identifier.

periodicity'bi_weekly' | 'monthly' | 'semi_monthly' | 'weekly'

Defines how often contractor invoices will be generated.

  • bi_weekly: Invoices will be generated every other week, on the given day of the week based on the start date.
  • monthly: Invoices will be generated once a month.
  • semi_monthly: Invoices will be generated at fixed dates twice a month (with 14 days of difference between each other), depending on the start date. In months with just 30 days, if start_date is set to the 31st day, then generation occurs in the last of day of the month.
  • weekly: Invoices will be generated each week.
start_datestring date

UTC date in ISO 8601 format

status'inactive' | 'deleted' | 'active' | 'processing'

Example request

{
  "currency": "USD",
  "items": [
    {
      "amount": 5000,
      "description": "Description"
    }
  ],
  "note": "Contractor invoice note",
  "nr_occurrences": 8,
  "number": "Num321",
  "periodicity": "monthly",
  "start_date": "2021-07-01",
  "status": "inactive"
}

Response

Success

Example response

{
  "data": {
    "contractor_invoice_schedule": {
      "currency": "BRL",
      "custom_days": [
        1,
        15
      ],
      "employment_id": "3a4b5c6d-7e8f-9a0b-1c2d-3e4f5a6b7c8d",
      "id": "663e0b79-c893-45ff-a1b2-f6dcabc098b5",
      "items": [
        {
          "amount": 5000,
          "description": "Description"
        }
      ],
      "next_invoice_at": "2024-06-15T00:00:00Z",
      "note": "Mobile developer payment.",
      "nr_occurrences": 10,
      "number": "ABC123",
      "periodicity": "semi_monthly",
      "start_date": "2024-06-01",
      "status": "active",
      "total_amount": 500000
    }
  }
}

Changes

  • 072424a83e5fRevision changes
    • info

      added the new optional request property

    • info

      added the optional property // to the response with the status

  • b20509567450Revision changes
    • warning

      added the new deleted enum value to the // response property for the response status

    • info

      added the new optional request property