Guía Técnica Para Consumo API Eventos Factura Electrónica

Clarisa ofrece una API que le permite a su sistema integrarse y reportar eventos asociados a su factura electrónica.

Tipos de eventos

  1. Acuse de recibo de la Factura Electrónica de venta
  2. Recibo del bien o prestación del servicio
  3. Aceptación expresa / Reclamo de la Factura Electrónica de venta

CABECERAS:

CABECERAVALOR
Content-Type application/json
Authorizationtoken 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
email 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
email 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