Crear una nota de remisión
Este endpoint está diseñado para facilitar la generación y emisión de notas de remisión. Para utilizarlo, necesitas realizar un POST request a `/dte/nr``, incluyendo la información necesaria en el cuerpo de la solicitud.
Detalles Técnicos
- HTTP Method: POST
- URL:
https://api.facturallama.com/dte/nr - Headers:
- X-API-Key: Tu API key.
- X-API-Version: La versión de la API que estás utilizando.
- Content-Type: application/json
Request Body
A continuación se presenta una descripción detallada de las propiedades que puedes incluir en el cuerpo de tu solicitud, así como las validaciones y formatos que debes tener en cuenta.
Propiedades Principales
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
id | UUID | Obligatorio. | Identificador del DTE (este valor se convertira en el código de generación para el Ministerio de Hacienda). |
generatedAt | Date | Opcional. | Fecha de generación del DTE. Formato: yyyy-MM-dd |
branchOffice | Object | Opcional. Ver detalles. | Datos de la sucursal y punto de venta. |
recipient | Object | Obligatorio. Ver detalles. | Información del destinatario. |
thirdPartySale | Object | Opcional. Ver detalles. | Información de venta a terceros. |
relatedTaxDocuments | Array | Opcional. Máximo de 50 objetos. Ver detalles. | Lista de documentos fiscales relacionados. |
items | Array | Obligatorio. Ver detalles. | Lista de ítems. |
discountNoSuj | Number | Opcional. Debe ser un número decimal positivo. | Descuento no sujeto. |
discountExe | Number | Opcional. Debe ser un número decimal positivo. | Descuento exento. |
discountGrav | Number | Opcional. Debe ser un número decimal positivo. | Descuento gravado. |
comments | String | Opcional. | Observaciones. |
Propiedades Anidadas
branchOffice
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
mhCode | String | Obligatorio. Debe ser un string de exactamente 4 caracteres. | Identificador de la sucursal. |
posNumber | Number | Obligatorio. Debe ser un número positivo. El valor no puede ser mayor a 999. | Identificador del punto de venta. |
recipient
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
economicActivity | Enum | Opcional. Debe coincidir con códigos de CAT-019. | Código de actividad económica. |
contributorSize | Enum | Opcional. | Tipo de pago. Valores: GRANDE, MEDIANO, OTROS |
contributorType | Enum | Opcional. | Tipo de pago. Valores: NATURAL, JURIDICA |
nrc | String | Opcional. La longitud del string debe ser de entre 1 y 8 caracteres. | Número de Registro de Contribuyente. Formato: ######## |
name | String | Obligatorio. Máximo: 150 caracteres. | Nombre del destinatario. |
phone | String | Opcional. Debe ser un string de exactamente 8 números. | Número de teléfono del destinatario. Formato: ######## |
commercialName | String | Opcional. Máximo: 150 caracteres. | Nombre comercial del destinatario. |
email | String | Obligatorio. Máximo: 100 caracteres. Debe ser un correo electrónico válido. | Correo electrónico del destinatario. |
address | Object | Obligatorio. Ver detalles. | Dirección del destinatario. |
identificationDocument | Object | Obligatorio. Ver detalles. | Documento de identificación del destinatario. |
assetTitle | Enum | Opcional. Default: OTROS. | Título a que se remiten los bienes. Valores: DEPOSITO, PROPIEDAD, CONSIGNACION, TRASLADO, OTROS. |
recipient.address
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
department | String | Obligatorio. | Departamento. Debe coincidir con códigos de CAT-012. |
municipality | String | Obligatorio. | Municipio. Debe coincidir con códigos de CAT-013. |
complement | String | Obligatorio. | Información adicional de dirección. |
recipient.identificationDocument
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
type | Enum | Obligatorio | Tipo de documento. Valores: NIT, DUI, PASAPORTE, CARNET_RESIDENTE,OTRO. |
number | String | Obligatorio | Número del documento de identificación. DUI: #########; NIT: ############## |
thirdPartySale
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
name | String | Obligatorio. Máximo: 150 caracteres. | Nombre de la tercera parte. |
identificationDocument | Object | Obligatorio. Ver detalles. | Documento de identificación de la tercera parte. |
thirdPartySale.identificationDocument
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
type | Enum | Obligatorio. | Tipo de documento. Valores: NIT, DUI, PASAPORTE, CARNET_RESIDENTE, OTRO. |
number | String | Obligatorio. | Número del documento de identificación. DUI: #########; NIT: ############## |
relatedTaxDocuments
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
id | String | Obligatorio. | Identificador único del documento relacionado. |
source | Enum | Opcional. | Tipo de generación del documento relacionado. Valores: FISICO, DIGITAL. |
type | Enum | Opcional. | Tipo de DTE del documento relacionado. Valores: FC, CCF. |
generatedAt | Date | Opcional. | Fecha de generación del documento relacionado. |
items
| Propiedad | Tipo | Validación | Descripción |
|---|---|---|---|
type | Enum | Obligatorio. | Tipo de ítem. Valores: BIENES, SERVICIOS, BIENES_Y_SERVICIOS, OTROS. |
internalCode | String | Opcional, Máximo: 25 caracteres. | Código interno del ítem. |
description | String | Obligatorio. Máximo: 1000 caracteres. | Descripción del ítem. |
quantity | Number | Obligatorio. Debe ser un número entero positivo. | Cantidad del ítem. |
unitMeasure | Enum | Opcional. Default: OTRA | Unidad de medida del ítem. Contiene diversas opciones, como METRO, YARDA, PIE, KILOGRAMO, etc. |
unitPrice | Number | Obligatorio. Debe ser un número decimal positivo. | Precio unitario del ítem. |
discountAmount | Number | Opcional. Debe ser un número decimal positivo. | Monto de descuento aplicado al ítem. |
saleType | Enum | Obligatorio. | Tipo de venta del ítem. Valores: NO_SUJETA, GRAVADA, EXENTA. |
documentNumber | String | Opcional. | Número de documento relacionado con el ítem. Este número debe estar presente en el arreglo de relatedTaxDocuments. |
Response Body
Una vez procesada tu solicitud, el servidor responderá con un conjunto de datos que confirmarán la creación del comprobante de crédito fiscal o, en caso de error, proporcionarán detalles sobre lo que salió mal.
| Propiedad | Tipo | Descripción |
|---|---|---|
id | UUID | Identificador único del DTE. |
companyId | UUID | Identificador único de la empresa. |
controlNumber | String | Este número es utilizado para identificar el DTE ante el Ministerio de Hacienda (MH). |
environment | Enum | Ambiente. Valores: TEST, LIVE. |
type | Enum | Tipo de documento fiscal. NR. |
version | Integer | Versión del DTE. |
status | Enum | Estado del DTE. Valores: CREATED, PROCESSING, APPROVED, REJECTED, INVALIDATED. |
mhResponse | Object | Respuesta del API del Ministerio de Hacienda. |
generatedAt | Timestamp | Fecha y hora de creación del DTE asignado manualmente. |
createdAt | Timestamp | Fecha y hora de creación del DTE. |