MarminDeveloper Docs
BusinessesPartnersProduct Wiki

Create a Sales Register Entry

Creates a document in the sales register. Use entry_type SALES or SALES_ADJUSTMENT and document_type INVOICE or CREDIT_NOTE. A valid bearer token is required.

Path parameter
POST /api/document-registers/{profile_id}
Authorization: Bearer {jwt_token}
ParameterTypeRequiredDescription
profile_idstring
Required
Business profile ID of the supplier. The API uses this to fill accounting_supplier_party, so you do not send it in the request body.
Supplier and customer from profile

For sales and sales adjustments:

Entry typeParty from profileIn request body
SALES, SALES_ADJUSTMENTSupplier (accounting_supplier_party)Do not send accounting_supplier_party. Send accounting_customer_party.

Use the same request body structure for all sales scenarios; only entry_type and document_type change.

Request body

Send a JSON object with the fields described in the Document register object. Typical combinations:

Scenarioentry_typedocument_type
Standard sales invoiceSALESINVOICE
Sales credit noteSALESCREDIT_NOTE
Sales adjustmentSALES_ADJUSTMENTINVOICE or CREDIT_NOTE
Response

Status code: 201 Created

Response body:

Returns the created register entry with request data and system‑generated fields (id, uuid, source_type, line ids, created_at, updated_at).

Error responses
400 Bad Request

Invalid request body or validation failed. The response returns an errors object with field names as keys and error messages as values.

401 Unauthorized

Authentication required or invalid token.

500 Internal Server Error

An error occurred while processing the request.

Next