curl --request POST \
--url https://api.lapyme.com.ar/api/v1/delivery-notes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"origin": {
"type": "sale",
"sale_id": "550e8400-e29b-41d4-a716-446655440100"
},
"date": "2026-08-30",
"notes": "2 pallets; weighed kilograms: 850",
"carrier": "Example carrier",
"delivery_address": "Ruta 9 km 12",
"recipient_name": "Juan Perez",
"recipient_document": "30123456"
}
'{
"request_id": "<string>",
"data": {
"object": "delivery_note",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": "<string>",
"date": "2023-12-25",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"object": "customer",
"email": "jsmith@example.com",
"phone": "<string>",
"tax_id_type": "<string>",
"tax_id": "<string>",
"tax_category": "<string>"
},
"origin": {
"type": "sale",
"sale_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"created_at": "2023-11-07T05:31:56Z",
"delivery_note_number": 123,
"point_of_sale": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"name": "<string>"
},
"carrier": "<string>",
"delivery_address": "<string>",
"scheduled_date": "2023-12-25",
"delivered_at": "2023-11-07T05:31:56Z",
"recipient_name": "<string>",
"recipient_document": "<string>",
"driver_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notes": "<string>",
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sale_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"name": "<string>",
"is_custom": true,
"warehouse_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sku": "<string>",
"name": "<string>",
"option_names": [
"<string>"
],
"variant_options": {},
"product_type": "product",
"kit_units": 123,
"object": "product"
}
}
],
"updated_at": "2023-11-07T05:31:56Z",
"idempotent_replay": true
}
}{
"request_id": "<string>",
"data": {
"object": "delivery_note",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": "<string>",
"date": "2023-12-25",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"object": "customer",
"email": "jsmith@example.com",
"phone": "<string>",
"tax_id_type": "<string>",
"tax_id": "<string>",
"tax_category": "<string>"
},
"origin": {
"type": "sale",
"sale_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"created_at": "2023-11-07T05:31:56Z",
"delivery_note_number": 123,
"point_of_sale": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"name": "<string>"
},
"carrier": "<string>",
"delivery_address": "<string>",
"scheduled_date": "2023-12-25",
"delivered_at": "2023-11-07T05:31:56Z",
"recipient_name": "<string>",
"recipient_document": "<string>",
"driver_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notes": "<string>",
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sale_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"name": "<string>",
"is_custom": true,
"warehouse_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sku": "<string>",
"name": "<string>",
"option_names": [
"<string>"
],
"variant_options": {},
"product_type": "product",
"kit_units": 123,
"object": "product"
}
}
],
"updated_at": "2023-11-07T05:31:56Z",
"idempotent_replay": true
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Invalid request or missing Idempotency-Key",
"retryable": false,
"details": []
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Missing or invalid API credential",
"retryable": false,
"details": []
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Insufficient scopes or location access",
"retryable": false,
"details": []
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Sale or standalone reference not found",
"retryable": false,
"details": []
}
}{
"request_id": "req_delivery_note_1",
"error": {
"type": "idempotency_error",
"code": "IDEMPOTENCY_CONFLICT",
"message": "The Idempotency-Key was already used with a different delivery note request.",
"retryable": false,
"details": []
}
}{
"request_id": "req_rate_limit_1",
"error": {
"type": "rate_limit_error",
"code": "RATE_LIMITED",
"message": "The organization request limit was reached. Try again later.",
"retryable": true,
"details": []
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Internal server error",
"retryable": false,
"details": []
}
}Create a delivery note
Creates one delivery note from an existing organization-scoped sale or from explicit standalone data. Sale origin derives customer, point of sale, items, quantities, product identity, and warehouses. Creation is independent from invoicing and preserves the current one-delivery-note-per-sale rule.
POST
/
api
/
v1
/
delivery-notes
curl --request POST \
--url https://api.lapyme.com.ar/api/v1/delivery-notes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"origin": {
"type": "sale",
"sale_id": "550e8400-e29b-41d4-a716-446655440100"
},
"date": "2026-08-30",
"notes": "2 pallets; weighed kilograms: 850",
"carrier": "Example carrier",
"delivery_address": "Ruta 9 km 12",
"recipient_name": "Juan Perez",
"recipient_document": "30123456"
}
'{
"request_id": "<string>",
"data": {
"object": "delivery_note",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": "<string>",
"date": "2023-12-25",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"object": "customer",
"email": "jsmith@example.com",
"phone": "<string>",
"tax_id_type": "<string>",
"tax_id": "<string>",
"tax_category": "<string>"
},
"origin": {
"type": "sale",
"sale_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"created_at": "2023-11-07T05:31:56Z",
"delivery_note_number": 123,
"point_of_sale": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"name": "<string>"
},
"carrier": "<string>",
"delivery_address": "<string>",
"scheduled_date": "2023-12-25",
"delivered_at": "2023-11-07T05:31:56Z",
"recipient_name": "<string>",
"recipient_document": "<string>",
"driver_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notes": "<string>",
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sale_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"name": "<string>",
"is_custom": true,
"warehouse_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sku": "<string>",
"name": "<string>",
"option_names": [
"<string>"
],
"variant_options": {},
"product_type": "product",
"kit_units": 123,
"object": "product"
}
}
],
"updated_at": "2023-11-07T05:31:56Z",
"idempotent_replay": true
}
}{
"request_id": "<string>",
"data": {
"object": "delivery_note",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": "<string>",
"date": "2023-12-25",
"customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"object": "customer",
"email": "jsmith@example.com",
"phone": "<string>",
"tax_id_type": "<string>",
"tax_id": "<string>",
"tax_category": "<string>"
},
"origin": {
"type": "sale",
"sale_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"created_at": "2023-11-07T05:31:56Z",
"delivery_note_number": 123,
"point_of_sale": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"number": 123,
"name": "<string>"
},
"carrier": "<string>",
"delivery_address": "<string>",
"scheduled_date": "2023-12-25",
"delivered_at": "2023-11-07T05:31:56Z",
"recipient_name": "<string>",
"recipient_document": "<string>",
"driver_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notes": "<string>",
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sale_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": 123,
"name": "<string>",
"is_custom": true,
"warehouse_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sku": "<string>",
"name": "<string>",
"option_names": [
"<string>"
],
"variant_options": {},
"product_type": "product",
"kit_units": 123,
"object": "product"
}
}
],
"updated_at": "2023-11-07T05:31:56Z",
"idempotent_replay": true
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Invalid request or missing Idempotency-Key",
"retryable": false,
"details": []
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Missing or invalid API credential",
"retryable": false,
"details": []
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Insufficient scopes or location access",
"retryable": false,
"details": []
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Sale or standalone reference not found",
"retryable": false,
"details": []
}
}{
"request_id": "req_delivery_note_1",
"error": {
"type": "idempotency_error",
"code": "IDEMPOTENCY_CONFLICT",
"message": "The Idempotency-Key was already used with a different delivery note request.",
"retryable": false,
"details": []
}
}{
"request_id": "req_rate_limit_1",
"error": {
"type": "rate_limit_error",
"code": "RATE_LIMITED",
"message": "The organization request limit was reached. Try again later.",
"retryable": true,
"details": []
}
}{
"request_id": "req_error_1",
"error": {
"type": "invalid_request_error",
"code": "INVALID_REQUEST",
"message": "Internal server error",
"retryable": false,
"details": []
}
}Authorizations
Incluí tu API key en el header Authorization con el prefijo Bearer.
Headers
Clave estable para deduplicar reintentos de la misma operación.
Body
application/json
Was this page helpful?