Find a delivery note by external ID
Look up a single delivery note by its external_id (sent in the JSON body), the integration key that maps it to a record in a third-party system (ERP/CRM/e-commerce). Returns the matching delivery note or 404 delivery_note_not_found if no delivery note uses that external_id within your company.
Request
- Base URL: https://api.factuarea.com/v1
- URL: https://api.factuarea.com/v1/companies/{company}/delivery-notes/find-by-external-id
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Path parameters
Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).
Headers
Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.
Request body
Response
Example response
{
"data": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a06",
"object": "delivery_note",
"number": "A-2026-00031",
"series": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0e",
"code": "F-2026"
},
"client": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",
"name": "Acme Corporation"
},
"status": "signed",
"issued_on": "2026-01-19",
"delivery_date": "2026-01-21",
"delivery_address": "Calle Mayor 12",
"delivery_city": "Alcoy",
"delivery_postal_code": "03801",
"delivery_province": "Alicante",
"delivery_country": "España",
"signed_at": "2026-01-21T14:50:00Z",
"signed_by": "María García López",
"signature_image_url": "https://files.factuarea.com/signatures/01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a06.png",
"transport_details": "Entrega en muelle 3, de 8:00 a 14:00.",
"vehicle_plate": "5678JKL",
"driver": {
"name": "Pedro Sánchez Ruiz",
"tax_id": "12345678Z"
},
"tracking": {
"number": "TRK-2026-0099",
"carrier": "SEUR"
},
"received_by": {
"name": "María García López",
"tax_id": "87654321X"
},
"billing_emails": [
"administracion@cliente.com"
],
"subtotal": "800.00",
"taxes_total": "168.00",
"total_vat": "168.00",
"total_retention": "0.00",
"total_surcharge": "0.00",
"total": "968.00",
"total_gross_weight_kg": "25.7500",
"lines_without_weight_count": 1,
"currency": "EUR",
"notes": "Entregado en almacén central.",
"external_id": "ERP-ALB-2026-0031",
"reference_number": "PO-2026-4471",
"lines": [
{
"description": "Cajas de material A4 (500u)",
"additional_description": "Auditoría inicial e informe de mejoras",
"product": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
"name": "Consultoría hora estándar"
},
"quantity": 2,
"unit_price": "400.0000",
"tax_rate": 21,
"subtotal": "800.00",
"taxes": "168.00",
"total": "968.00",
"counted_quantity": "4.0000",
"configuration": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c04",
"name": "Caja A4 · Cartón reforzado",
"signature": "35c8be09d174a2f6031e7bc4980d5a2e6f31097bd4a85c26e10f739b48d20ac5"
},
"options": [
{
"group": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c14",
"name": "Acabado"
},
"value": {
"id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c24",
"name": "Cartón reforzado"
},
"price_adjustment": "40.0000",
"applied": true
}
],
"price_semantics": "per_commercial_unit",
"price_adjustment_total": "40.0000",
"gross_weight_kg": "25.0000"
}
],
"metadata": {
"erp_code": "IVA-GEN",
"ledger_account": "477000"
},
"tags": [
"logistica",
"almacen-central"
],
"custom_fields": [
{
"field": "muelle_carga",
"value": "Muelle 3"
}
],
"created_at": "2026-01-19T08:00:00Z",
"updated_at": "2026-01-21T14:50:00Z"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.