Reclamo de la Factura Electrónica de Venta¶
Url POST¶
/v1/031
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.
- rejection_concept_code *
type:
Código de concepto de rechazo.
01
Documento con inconsistencias
02
Mercancía no entregada
03
Mercancía entregada parcialmente
04
Servicio no prestado
- 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://test.endpoint.emision.co/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://test.endpoint.emision.co/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://test.endpoint.emision.co/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 Reclamo de la Factura Electrónica de Venta 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 }