v1

latestOpenAPI 3.1.02026-08-04103211436.0 KB
Operations

Create operations in bulk

Creates several operations in a single call, following the same rules as the single operation creation endpoint. Operations sharing the same customId within the request are deduplicated and only the first occurrence is processed; operations with amount equal to 0 are silently discarded. If none of the submitted operations are eligible, the call still returns 200 with an empty data list.

post/operations/{companyId}/bulk

Path parameters

companyIdstring required

Request body

Example request

{
  "data": [
    {
      "concept": "Invoice #2024-001",
      "amount": 1250.5,
      "accountingAmount": 1250.5,
      "pendingAmount": 1250.5,
      "pendingAccountingAmount": 1250.5,
      "exchangeRate": 1,
      "paymentMethod": "bank-transaction",
      "contact": {
        "tradeName": "Acme Supplies",
        "legalName": "Acme Supplies S.L.",
        "taxId": "B12345678",
        "contact": {
          "phone": "+34600000000",
          "email": "billing@acme-supplies.com",
          "name": "John",
          "surname": "Doe"
        },
        "address": {
          "postalCode": "28001",
          "address": "Calle Mayor 10, 3B",
          "province": "Madrid",
          "city": "Madrid",
          "country": "Spain"
        },
        "accounts": [
          {
            "swift": "BBVAESMMXXX",
            "iban": "ES9121000418450200051332"
          }
        ],
        "paymentsAccounts": [
          {
            "details": {
              "iban": "ES9121000418450200051332",
              "bic": "BBVAESMMXXX",
              "swift": "BBVAESMMXXX",
              "accountNumber": "123456789",
              "routingNumber": "021000021",
              "sortCode": "040004",
              "institutionNumber": "001",
              "transitNumber": "12345",
              "bsb": "062-000"
            }
          }
        ],
        "accountingCode": "4300001",
        "paymentMethod": "bank-transaction",
        "paymentTerms": 30,
        "attributes": [
          {
            "customId": "cost-center",
            "value": "Marketing",
            "valueCustomId": "marketing"
          }
        ],
        "customId": "erp-contact-001"
      },
      "attributes": [
        {
          "customId": "cost-center",
          "value": "Marketing",
          "valueCustomId": "marketing"
        }
      ],
      "customId": "invoice-2024-001"
    }
  ]
}

Response

Successful Response