--- title: "Crear remito" method: POST path: "/api/v1/delivery-notes" tags: ["API"] --- # Crear remito `POST /api/v1/delivery-notes` ## Request - Base URL: `https://api.lapyme.com.ar` - URL: `https://api.lapyme.com.ar/api/v1/delivery-notes` - Auth: HTTP bearer Crea un remito a partir de una venta existente de la organización o de datos independientes. Si el origen es una venta, toma de ella el cliente, punto de venta, artículos, cantidades, productos y depósitos. La creación es independiente de la facturación y mantiene la regla de un solo remito por venta. ## Headers - `Idempotency-Key` string, required ## Request body - union - object - `date` string, date - `notes` string, nullable - `carrier` string, nullable - `delivery_address` string, nullable - `scheduled_date` string, date, nullable - `recipient_name` string, nullable - `recipient_document` string, nullable - `origin` ApiSharedObjectc15d6ab2fa, required - `type` 'sale', required - `sale_id` string, uuid, required - object - `date` string, date - `notes` string, nullable - `carrier` string, nullable - `delivery_address` string, nullable - `scheduled_date` string, date, nullable - `recipient_name` string, nullable - `recipient_document` string, nullable - `origin` ApiSharedObject05f64e43bb, required - `type` 'custom', required - `customer_id` string, uuid, required - `point_of_sale_id` string, uuid, required - `items` union[], required - union - object - `product_id` string, uuid, required - `warehouse_id` string, uuid - `name` string - `is_custom` false - `quantity` number, required - object - `name` string, required - `is_custom` true, required - `quantity` number, required ## Response `200` Reproducción idempotente del remito existente - ApiDeliveryNoteWriteResponse - `request_id` string, required - `data` object, required - `numbering_mode` 'legacy' | 'managed', required - `revision` integer, required - `legal_issuance` ApiSharedObject5a67c4e4e1, required - `id` string, uuid, required - `talonario_id` string, uuid, required - `authorization_id` string, uuid, required - `number` integer, required - `formatted_number` string, required - `emission_point` integer, required - `cai` string, required - `expires_on` string, date, required - `issued_on` string, date, required - `created_at` string, date-time, required - `created_by` string, uuid, required - `delivery_revision` integer, required - `voided_at` string, date-time, nullable, required - `voided_by` string, uuid, nullable, required - `void_reason` string, nullable, required - `object` 'delivery_note', required - `id` string, uuid, required - `number` string, nullable, required - `date` string, date, required - `customer` ApiSharedObject5e70e1df84, required - `object` 'customer' - `id` string, uuid, required - `name` string, nullable, required - `email` string, email, nullable - `phone` string, nullable - `tax_id_type` string, nullable - `tax_id` string, nullable - `tax_category` string, nullable - `origin` union, required - ApiSharedObjectc15d6ab2fa - `type` 'sale', required - `sale_id` string, uuid, required - ApiSharedObject5a978938b1 - `type` 'fulfillment', required - `fulfillment_id` string, uuid, required - ApiSharedObject05f64e43bb - `type` 'custom', required - `created_at` string, date-time, required - `content_hash` string, nullable, required: Huella de los datos de impresión revisados. Enviá este valor como expected_content_hash al emitir un borrador. - `issuer` ApiSharedObjectd6ec566aaf, required - `legal_name` string, required - `tax_id` string, nullable, required - `tax_id_type` string, nullable, required - `tax_category` string, nullable, required - `address` string, nullable, required - `apartment` string, nullable, required - `city` string, nullable, required - `province` string, nullable, required - `postal_code` string, nullable, required - `phone` string, nullable, required - `gross_income_tax_amount` string, nullable, required - `activities_started_at` string, nullable, required - `eligible_talonarios` ApiSharedObjecte2a101a3b5[], required: Talonarios vigentes para el borrador y su ubicación. La hoja propuesta se confirma al emitir. - `id` string, uuid, required - `name` string, required - `emission_point` integer, required - `next_number` integer, required - `layout_revision_id` string, uuid, nullable, required: Revisión inmutable del diseño de este talonario. Enviá este valor como expected_layout_revision_id al emitir. Es null para diseños anteriores sin revisión publicada. - `cai` string, required - `expires_on` string, date, required - `delivery_note_number` integer, required - `point_of_sale` ApiSharedObject94c0cab352, required - `id` string, uuid, required - `number` integer, required - `name` string, nullable, required - `carrier` string, nullable, required - `delivery_address` string, nullable, required - `scheduled_date` string, date, nullable, required - `delivered_at` string, date-time, nullable, required - `recipient_name` string, nullable, required - `recipient_document` string, nullable, required - `driver_id` string, uuid, nullable, required - `notes` string, nullable, required - `items` ApiSharedObject912052d04a[], required - `id` string, uuid, required - `sale_item_id` string, uuid, nullable, required - `quantity` number, required - `name` string, nullable, required - `is_custom` boolean, required - `warehouse_id` string, uuid, nullable, required - `product` ApiSharedObject0a16670526, required - `object` 'product' - `id` string, uuid, required - `sku` string, nullable, required - `name` string, nullable, required - `option_names` string[], nullable, required - `variant_options` object, nullable, required - `product_type` 'product' | 'combo' | 'kit' | 'service', required - `kit_units` number, required - `updated_at` string, date-time, required - `idempotent_replay` boolean, required ## Other responses - `201`: Remito creado - `400`: Solicitud inválida o Idempotency-Key faltante - `401`: Credencial de API faltante o inválida - `403`: Scopes insuficientes o acceso a la ubicación no autorizado - `404`: Venta o referencia del remito independiente no encontrada - `409`: Conflicto de estado o idempotencia - `429`: Límite de solicitudes excedido para la organización - `500`: Error interno del servidor - `503`: Verificación de credenciales temporalmente ocupada; reintentá sin cambiar la operación ni su Idempotency-Key. ## Changes - **2026-11-03** `067bbb55f421`: 2 info - added the required property `data/eligible_talonarios/items/layout_revision_id` to the response with the `200` status - added the required property `data/eligible_talonarios/items/layout_revision_id` to the response with the `201` status - **2026-11-03** `ed0d46e68fbe`: 1 info - endpoint added [Operation history](https://skmtc.dev/lapyme/apis/la-pyme-api/changes/api/v1/delivery-notes/post.md) --- [API](https://skmtc.dev/lapyme/apis/la-pyme-api.md) - [All operations](https://skmtc.dev/lapyme/apis/la-pyme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lapyme/apis/la-pyme-api/revisions/067bbb55f421?raw)