latestOpenAPI 3.0.12026-08-18132038.0 KB

310150fbd68d

Orders

Create a Plunet order with items

Create an Order + OrderItems in Plunet from Airtable-mapped data. Idempotent on external_id: the second POST returns 200 with the existing order.

post/V1/orders

Request body

Example request

{
  "order": {
    "external_id": "rec_AIRTABLE_RECORD_ID",
    "customer": {
      "plunet_id": 12345
    },
    "project_manager": {
      "email": "pm@worders.net"
    },
    "contact_person": {
      "plunet_id": 67890
    },
    "project_name": "Adobe — Acrobat Q2 update",
    "subject": "Translation of help articles",
    "currency": "EUR",
    "rate": 0.1,
    "template_id": 42,
    "items": [
      {
        "language_source": "en-US",
        "language_target": "fr-FR",
        "quantity": 1200
      }
    ]
  }
}

Response

returns the existing order when external_id matches

idstring nullable

Plunet order id

plunet_idstring nullable

Same as id

createdboolean

true when newly created, false when idempotent hit on existing external_id

order_referencestring nullable

statusstring nullable

external_idstring nullable

Example response

{
  "id": "O-78901",
  "status": "in_preparation"
}