Recibo del bien y/o prestación del servicio¶
Url POST¶
/v1/032
Headers¶
Content-Type: application/json Accept: application/json Authorization: Bearer token
Parameters¶
- send:
type: boolean
Indica si envía correo al emisor y receptor de la factura.
- number * :
type: integer
Número del evento.
- identification_number * :
type: integer
Número de identificación de la compañía que genera el evento, receptor habilitado.
- sender_party:
type: object
Grupo para informar persona o institución que genera el evento.
- identification_type_code:
type: integer
Código de documento de identidad.
Nota
Ver listado en https://endpoint.mb.emision.dev/dian-tables/IdentificationType.
- identification_number:
type:
Número de identificación.
- name:
type: string
Razón social.
- receiver_party:
type: object
Grupo para informar persona o institución que recibe el evento.
- identification_type_code:
type: integer
Código de documento de identidad.
Nota
Ver listado en https://endpoint.mb.emision.dev/dian-tables/IdentificationType.
- identification_number:
type:
Número de identificación.
- name:
type: string
Razón social.
- document_reference:
type: object
Grupo para informar el documento al cual está referenciado el evento.
- number:
type: string
Prefijo y Número del documento referenciado.
- uuid:
type: string
CUFE del documento referenciado.
- person:
type: object
Grupo para informar la persona dentro de la compañía que genera el evento. Ejem: Contadora, Bodegista, Administrador, Gerente, etc.
- identification_type_code:
type: integer
Código de documento de identidad.
Nota
Ver listado en https://endpoint.mb.emision.dev/dian-tables/IdentificationType.
- identification_number:
type:
Número de identificación.
- organization_department:
type: string
Departamento de organización.
- job_title:
type: string
Título profesional.
- first_name:
type: string
Nombre.
- family_name:
type: string
Apellido.
Body¶
1 { 2 "send": true, 3 "number": 1, 4 "identification_number": "901285179", 5 "rejection_concept_code": "03", 6 "sender_party": { 7 "identification_type_code": 31, 8 "identification_number": "901285179", 9 "name": "NODEXUM S.A.S" 10 }, 11 "receiver_party": { 12 "identification_type_code": 31, 13 "identification_number": "901285179", 14 "name": "NODEXUM" 15 }, 16 "document_reference": { 17 "number": "SETP990058466", 18 "uuid": "57627c90b9c3317dd28b56d9e2731a97122e3649fbff7341c6a3d0b3ff1a650b2fcd6d38212804ff4b75f74b12c0f568" 19 }, 20 "person": { 21 "identification_type_code": 13, 22 "identification_number": "1234567890", 23 "organization_department": "Administrativa", 24 "job_title": "Gerente de Operaciones", 25 "first_name": "Pepito", 26 "family_name": "Perez" 27 } 28 }
Responses¶
Response 200 OK¶
Si el documento ha superado las validaciones y fue enviado a la DIAN.
1 { 2 "status": "success",// Estado de la solicitud. 3 "message": "Evento Recibo del bien y/o prestación del servicio enviado a la DIAN",// Mensaje sobre el estado de la solicitud. 4 "event": { // Datos generados para el documento contenido en la solicitud. 5 "number": "10020", // Consecutivo. 6 "statusCode": 5,// Código para identificar el estado. 7 "statusDescription": "Documento validado exitosamente",// Descripción al código de estado. 8 "uuid": "Cune",// Cune generado para el evento 9 "Base64Bytes": "Xml",// Xml codificado en base64 comprimido en un archivo zip 10 "appResponseBase64Bytes": "Application response", // XML de la respuesta de la DIAN codificado en base64. 11 "attachedDocumentBase64Bytes": "Attached document" // XML que contiene el XML del evento y el APP response. 12 } 13 }
Response 422¶
Si el body no cumple con las validaciones, devolverá los errores en un arreglo los cuales deben ser solucionados para poder continuar con el ciclo del documento electrónico (Evento Mercantil).
Errores por parte de la DIAN
1 { 2 "status": "error", // Estado de la solicitud. 3 "message": "El documento contiene algunos errores.", // Mensaje sobre el estado de la solicitud. 4 "event": { // Datos generados para el documento contenido en la solicitud. 5 "number": "10019", // Consecutivo. 6 "uuid": "Cune", //CUNE 7 "statusCode": 11, // Código para identificar el estado. 8 "statusDescription": "DIAN rechazo el documento ", // Descripción al código de estado. 9 "errors": [ // Lista de los campos y errores que presenta el documento. 10 "Regla: LGC01, Rechazo: Evento registrado previamente" 11 ] 12 } 13 }Errores por parte e-Misión
1 { 2 "status": "error", // Estado de la solicitud. 3 "message": "La solicitud del evento Acuse de recibo de Factura Electrónica de Venta contiene algunos errores", // Mensaje sobre el estado de la solicitud. 4 "event": { 5 "number": 10019, 6 "statusCode": 13, 7 "statusDescription": "EL documento no supero las validaciones e-Misión", // Descripción al código de estado. 8 "errors": [ // Lista errores que presenta el documento. 9 "tipo de documento es inválido.", 10 "CUFE del documento electrónico afectado es inválido." 11 ], 12 "detailedErrors": { // Lista errores que presenta el documento en cada campo. 13 "person.identification_type_code": [ // Campo que presenta el error. 14 "tipo de documento es inválido." // Lista de errores del campo. 15 ], 16 "document_reference.uuid": [ 17 "CUFE del documento electrónico afectado es inválido." 18 ] 19 } 20 } 21 }