Clarisa ofrece una API que le permite a su sistema integrarse y reportar eventos asociados a su factura electrónica de compra.
Tipos de eventos
- Acuse de recibo de la Factura Electrónica de compra
- Recibo del bien o prestación del servicio
- Aceptación expresa / Reclamo de la Factura Electrónica de venta
CABECERAS:
| CABECERA | VALOR |
| Content-Type | application/json |
| Authorization | token de usuario |
Generar Evento Acuse de Recibo de la Factura Electrónica de Venta
METODO : "POST"
Recibo del bien o prestación del servicio
METODO : "POST"
Petición:
| Nombre | Formato | Tamaño | Descripción |
|---|---|---|---|
| nit | Alfanumérico | 100 | NIT de la empresa sin dígito de verificación |
| tipoEvento | String | 100 | Especifica el tipo de evento que se va a emitir, ver tabla Eventos. |
| conceptoRechazo | String | 100 | Se indica motivo de rechazo de la factura, ver tabla Motivos de Rechazo. |
| observacion | Alfanumérico | 100 | Observación |
| factura | Lista {} | Lineas de la factura. | |
| factura.cufe | Alfanumérico | 100 | Código Unico de la Factura Electronica a la cual se generará el evento. |
| factura.numeroDocumentoComercial | Alfanumérico | 100 | Número del documento electrónico |
| factura.fechaGeneracion | String | 100 | Fecha de generación del documento electrónico (Formato: yyyy-MM-dd hh:mm:ss) |
| factura.fechaVencimiento | String | 100 | Fecha de vencimiento del documento electrónico(Formato: yyyy-MM-dd hh:mm:ss) |
| datosResolucion | Lista {} | Datos de numeración. | |
| numeroAutorizacion | numérico | 100 | Número de resolucion aprobada en la DIAN |
| inicioAutorizacion | String | 100 | Fecha inicio periodo de resolución(Formato:yyyy-MM-dd) |
| finAutorizacion | String | 100 | Fecha fin periodo de resolución(Formato:yyyy-MM-dd) |
| prefijoAutorizacion | String | 100 | Prefijo segun resolución |
| rangoInicioAutorizacion | numérico | 100 | Rango de inicio de la numeración |
| rangoFinAutorizacion | numérico | 100 | Rango fin de numeración |
| emisorFactura | Lista {} | Datos del emisor. | |
| primerApellido | String | 100 | Primer apellido del emisor de la factura, aplica a Persona Natural |
| segundoApellido | String | 100 | Segundo apellido del emisor de la factura, aplica a Persona Natural |
| primerNombre | String | 100 | Primer nombre del emisor de la factura, aplica a Persona Natural |
| otrosNombres | String | 100 | Demas nombres del emisor de la factura, aplica a Persona Natural |
| razonSocial | String | 100 | Nombre de la entidad emisora de la factura, aplica a Persona Jurídica |
| numeroDocumento | Alfanumérico | 100 | Número documento de identificación de emisor de factura |
| tipoDocumento | String | 100 | Tipo documento de identificación Ver Tabla Tipos de Documento |
| naturaleza | String | 100 | Tipos de naturaleza ver tabla Tipos de Naturaleza |
| responTributaria | Alfanumérico | 100 | Códigos de Responsabilidad Tributaria ver tabla Responsabilidades Tributarias |
| Alfanumérico | 100 | Correo electrónico | |
| receptorFacturaBienes | Lista {} | Datos del receptor | |
| tipoDocumento | String | 100 | Tipo documento de identificación Ver Tabla Tipos de Documento |
| numeroDocumento | Alfanumérico | 100 | Número documento de identificación de receptor de factura |
| primerApellido | String | 100 | Primer apellido del receptor de la factura |
| segundoApellido | String | 100 | Segundo apellido del receptor de la factura |
| primerNombre | String | 100 | Primer nombre del receptor de la factura |
| otrosNombres | String | 100 | Demas nombres del receptor de la factura |
| cargo | String | 100 | Se indica cargo correspondiente al receptor de la factura |
| area | String | 100 | Indica el área a la cual corresponde el receptor de la factura |
| Nombre | Codigo |
|---|---|
| Acuse | ACUSE_RECIBO_FACTURA_ELECTRONICA |
| Recibo | RECIBO_BIEN_SERVICIO |
| Nombre | Codigo |
|---|---|
| cedula de ciudadania | CC |
| NIT | NI |
| tarjeta de identidad | TI |
| Pasaporte | PA |
| Tarjeta de extranjeria | TE |
| Cedula de extranjeria | CE |
| Registro civil de nacimiento | RC |
| Nit de otro país | NO |
| NUIP | NU |
| Carné diplomatico | CD |
| Salvonconducto | SC |
| Permiso Especial de permanencia | PE |
| Certificado de nacido vivo | CN |
| Adulto sin identificar | AS |
| Menor sin identificar | MS |
| Documento extranjero | DE |
| Sin identificación | SI |
| Documento de identificación extranjero | DE |
| PEP | PE |
Si el cliente presenta varias responsabilidades fiscales, sus códigos deben ir separados por coma
| Nombre | Código |
|---|---|
| Gran contribuyente | O-13 |
| Autorretenedor | O-15 |
| Agente de retención en el impuesto sobre las ventas | O-23 |
| Régimen de tributación- SIMPLE | O-47 |
| No responsable | R-99-PN |
| Nombre | Código |
|---|---|
| Impuesto al valor agregado | IVA |
| Impuesto Nacional al Consumo | INC |
| IVA + INC | IVA_E_INC |
| No aplica | NO_APLICA |
| Nombre | Código |
|---|---|
| Persona Natural | NATURALES |
| Persona Jurídica | JURIDICAS |
Correcto
En caso de que la petición se ejecute sin errores se devolverá la siguiente respuesta:
Error
Si la solicitud no es correcta, recibirá la siguiente respuesta:
CÓDIGO HTTP: 400 | 401 | 500
Generar Evento Aceptación Expresa
METODO : "POST"
Reclamo de la Factura Electrónica de venta
METODO : "POST"
Petición:
| Nombre | Formato | Tamaño | Descripción |
|---|---|---|---|
| nit | Alfanumérico | 100 | NIT de la empresa sin dígito de verificación |
| tipoEvento | String | 100 | Especifica el tipo de evento que se va a emitir, ver tabla Eventos. |
| conceptoRechazo | String | 100 | Se indica motivo de rechazo de la factura, ver tabla Motivos de Rechazo. |
| observacion | Alfanumérico | 100 | Observación |
| factura | Lista {} | Lineas de la factura. | |
| factura.cufe | Alfanumérico | 100 | Código Unico de la Factura Electronica a la cual se generará el evento. |
| factura.numeroDocumentoComercial | Alfanumérico | 100 | Número del documento electrónico |
| factura.fechaGeneracion | String | 100 | Fecha de generación del documento electrónico (Formato: yyyy-MM-dd hh:mm:ss) |
| factura.fechaVencimiento | String | 100 | Fecha de vencimiento del documento electrónico(Formato: yyyy-MM-dd hh:mm:ss) |
| datosResolucion | Lista {} | Datos de numeración. | |
| numeroAutorizacion | numérico | 100 | Número de resolucion aprobada en la DIAN |
| inicioAutorizacion | String | 100 | Fecha inicio periodo de resolución(Formato:yyyy-MM-dd) |
| finAutorizacion | String | 100 | Fecha fin periodo de resolución(Formato:yyyy-MM-dd) |
| prefijoAutorizacion | String | 100 | Prefijo segun resolución |
| rangoInicioAutorizacion | numérico | 100 | Rango de inicio de la numeración |
| rangoFinAutorizacion | numérico | 100 | Rango fin de numeración |
| emisorFactura | Lista {} | Datos del emisor. | |
| primerApellido | String | 100 | Primer apellido del emisor de la factura, aplica a Persona Natural |
| segundoApellido | String | 100 | Segundo apellido del emisor de la factura, aplica a Persona Natural |
| primerNombre | String | 100 | Primer nombre del emisor de la factura, aplica a Persona Natural |
| otrosNombres | String | 100 | Demas nombres del emisor de la factura, aplica a Persona Natural |
| razonSocial | String | 100 | Nombre de la entidad emisora de la factura, aplica a Persona Jurídica |
| numeroDocumento | Alfanumérico | 100 | Número documento de identificación de emisor de factura |
| tipoDocumento | String | 100 | Tipo documento de identificación ver tabla Tipos de Documento |
| naturaleza | String | 100 | Tipos de naturaleza ver tabla Tipos de Naturaleza |
| responTributaria | Alfanumérico | 100 | Códigos de Responsabilidad Tributaria ver tabla Responsabilidades Tributarias |
| Alfanumérico | 100 | Correo electrónico |
| Nombre | Codigo |
|---|---|
| Aceptacion | ACEPTACION_EXPRESA |
| Rechazo | RECLAMO_FACTURA |
| Nombre | Código |
|---|---|
| Documento con inconsistencias | DOCUMENTO_INCONSISTENTE |
| Mercancía no entregada totalmente | MERCANCIA_NO_ENTREGADA_TOTALMENTE |
| Mercancía no entregada parcialmente | MERCANCIA_NO_ENTREGADA_PARCIALMENTE |
| Servicio no prestado | SERVICIO_NO_PRESTADO |