Upsert purchase orders (full records)
POST/v1/purchaseorder
Purchase order headers, keyed per source system by source_document_id. Deleting a PO removes its lines and receipts; sending it again restores exactly what is sent.
Keys: id, source_system + source_document_id. Rights: READ_PURCHASEORDER to read, POST_PURCHASEORDER to write (and READ_DATA / POST_DATA).
Up to 1,000 records. Each record is matched by its keys and created or updated as a whole: fields left out get their default (except fields marked "kept"). Whether a record of another source system, or one entered in Nuntiq, may be changed depends on the API user's record ownership: All records, All integrated records (never records entered in Nuntiq), All records where the source system matches (default: its own records; records entered in Nuntiq are taken over), or All integrated records where the source system matches (its own records only). Otherwise the record is refused (owned_by_other_source). Only real changes are written; the answer says per record created, updated (with the changed fields) or unchanged.
Request
Responses
- 200
- 207
- 400
- 401
- 403
- 413
- 422
Every record succeeded
Some records were rejected or not found (see each result)
The request itself is invalid (not an array, empty)
Missing or invalid API key
The key lacks the right, or the record is outside its organizations
More than 1,000 records
Every record was rejected, or all_or_none rolled the request back (results inside)