Mark a delivery note as delivered | Monite Documentation

curl -X POST https://api.sandbox.monite.com/v1/delivery_notes/delivery_note_id/mark_as_delivered \
     -H "x-monite-version: 2024-05-25" \
     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
     -H "Authorization: Bearer <token>"

{
  "id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "created_at": "2022-01-01T00:00:00Z",
  "updated_at": "2022-01-01T00:00:00Z",
  "counterpart": {
    "id": "id",
    "individual": {
      "first_name": "Adnan",
      "is_customer": true,
      "is_vendor": true,
      "last_name": "Singh",
      "email": "asingh@example.net",
      "phone": "5553211234",
      "tags": [
        {
          "id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
          "created_at": "2022-09-07T16:35:18Z",
          "updated_at": "2022-09-07T16:35:18Z",
          "name": "Marketing",
          "category": "document_type",
          "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
          "description": "Tag for the Marketing Department"
        }
      ],
      "title": "Mr."
    },
    "language": "ab",
    "organization": {
      "is_customer": true,
      "is_vendor": true,
      "legal_name": "Acme Inc.",
      "email": "acme@example.com",
      "phone": "5551231234",
      "tags": [
        {
          "id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
          "created_at": "2022-09-07T16:35:18Z",
          "updated_at": "2022-09-07T16:35:18Z",
          "name": "Marketing",
          "category": "document_type",
          "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
          "description": "Tag for the Marketing Department"
        }
      ]
    }
  },
  "counterpart_address": {
    "city": "Counterpart City",
    "country": "DE",
    "line1": "Counterpart Street",
    "postal_code": "123009",
    "line2": "line2",
    "state": "state"
  },
  "counterpart_id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "display_signature_placeholder": true,
  "document_id": "DN-2022-01-01-0001",
  "entity": {
    "type": "organization",
    "name": "name",
    "email": "email",
    "logo": "logo",
    "phone": "phone",
    "registration_authority": "registration_authority",
    "registration_number": "registration_number",
    "tax_id": "tax_id",
    "vat_id": "vat_id",
    "website": "website"
  },
  "entity_address": {
    "city": "Entity City",
    "line1": "Entity Street",
    "postal_code": "123009",
    "country": "DE",
    "line2": "line2",
    "state": "state"
  },
  "entity_id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "file_language": "en",
  "line_items": [
    {
      "product": {
        "name": "Product Name",
        "description": "Description of product",
        "measure_unit": {
          "name": "pcs",
          "description": "Pieces"
        }
      },
      "quantity": 20
    }
  ],
  "original_file_language": "de",
  "status": "created",
  "based_on": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "based_on_document_id": "IN-2022-01-01-0001",
  "created_by_entity_user_id": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
  "delivery_date": "2022-01-01",
  "delivery_number": "102-2022-0987",
  "file_url": "https://example.com/delivery_note.pdf",
  "memo": "This is a memo",
  "original_file_url": "https://example.com/delivery_note_original.pdf"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

delivery_note_idstringRequired

Headers

x-monite-versionstringRequired

x-monite-entity-idstringRequired

The ID of the entity that owns the requested resource.

Response

Successful Response

idstringformat: "uuid"

Unique ID of the delivery note

created_atdatetime

Time at which the delivery note was created. Timestamps follow the ISO 8601 standard.

updated_atdatetime

Time at which the delivery note was last updated. Timestamps follow the ISO 8601 standard.

counterpartobject

Counterpart of the delivery note

counterpart_addressobject

Address of the counterpart

counterpart_idstringformat: "uuid"

ID of the counterpart

display_signature_placeholderboolean

Whether to display a signature placeholder in the generated PDF

document_idstring

Document ID of the delivery note

entityobject

Entity that created the delivery note

entity_addressobject

Address of the entity that created the delivery note

entity_idstringformat: "uuid"

ID of the entity that created the delivery note

file_languageenum

The language of the customer-facing PDF file (file_url). The value matches the counterpart’s language at the time when this PDF file was generated.

line_itemslist of objects

List of line items in the delivery note

original_file_languageenum

The language of the entity’s copy of the PDF file (original_file_url). The value matches the entity’s language at the time when this PDF file was generated.

statusenum

Status of the delivery note

Allowed values:

based_onstringformat: "uuid"

The unique ID of a previous document related to the delivery note if applicable.

based_on_document_idstring

The unique document ID of a previous document related to the delivery note if applicable.

created_by_entity_user_idstringformat: "uuid"

ID of the user that created the delivery note

delivery_datestringformat: "date"

Date of delivery

delivery_numberstring

Delivery number

file_urlstring

The delivery note’s PDF URL in the customer-facing language.

memostring

An optional note for the customer, displayed above the line items table in the PDF.

original_file_urlstring

The delivery note's PDF URL in the entity's language.

Errors

400

Post Delivery Notes ID Mark as Delivered Request Bad Request Error

401

Post Delivery Notes ID Mark as Delivered Request Unauthorized Error

403

Post Delivery Notes ID Mark as Delivered Request Forbidden Error

404

Post Delivery Notes ID Mark as Delivered Request Not Found Error

409

Post Delivery Notes ID Mark as Delivered Request Conflict Error

422

Post Delivery Notes ID Mark as Delivered Request Unprocessable Entity Error

429

Post Delivery Notes ID Mark as Delivered Request Too Many Requests Error