Clarisa ofrece una API que le permite a su sistema integrarse y realizar facturas de Exportación.
Contamos con la verificación y validación de sus facturas para lograr ser aceptadas y reportadas a la DIAN .
Las acciones disponibles para la API de facturación de exportación son:
- Crear Factura electrónica tipo exportación
Importante !
Para el envío masivo de facturas, es decir mas de una factura, se debe enviar cada petición con intervalo de 5 segundos como mínimo.
Crear Factura electrónica Exportación
CABECERAS:
| CABECERAS | VALOR |
| Content-Type | application/json |
| Authorization | token de usuario |
METODO : "POST"
Información adicional para enviar a nivel de ítem
Petición:
| Nombre | Formato | Tamaño | Descripción |
|---|---|---|---|
| NIT | Alfanumérico | 100 | NIT de la empresa sin dígito de verificación |
| cliente | Datos del Cliente del documento electrónico | ||
| cliente.nombreRazonSocial | Alfanumérico | 100 | Cliente: Razón social o Nombre |
| cliente.tipoIdentificacion | Alfanumérico | 100 | Código del tipo de identificación, véase la lista tipo de identificación. |
| cliente.numIdentificacion | númerico | 100 | Número de identificación de cliente, sin dígito de verificación. |
| cliente.naturaleza | String | 100 | Código de la naturaleza del cliente, véase valores para Naturaleza |
| cliente.direccion | Alfanumérico | 100 | Dirección Cliente |
| cliente.ciudad | Alfanumérico | 100 | Identificador de la ciudad del cliente, véase la tabla valores para ciudad |
| cliente.telefono | numérico | 100 | Télefono del cliente |
| cliente.email | Alfanumérico | 100 | correo Electrónico |
| cliente.responsabilidadesFiscales | Alfanumérico | 100 | Código de responsabilidades fiscales, véase tabla Responsabilidades fiscales cliente |
| cliente.respTributarias | Alfanumérico | 100 | Código de responsabilidades tributarias, véase tabla Valores para Responsabilidades tributarias cliente |
| numeroDocumentoComercial | numérico | 100 | Número del documento electrónico |
| fechaGeneracion | String | 100 | Fecha de generación del documento electrónico (Formato: yyyy-MM-ddThh:mm:ss) |
| fechaVencimiento | String | 100 | Fecha de vencimiento del documento electrónico(Formato: yyyy-MM-ddThh:mm:ss) |
| mediosPago | Alfanumérico | 100 | Códigos de la DIAN de los medios de pago con los que se pagó el documento electrónico, dichos códigos van separados por coma. revisar tabla valores para medios de pago |
| incoterms | Alfanumérico | 100 | Códigos para condiciones de entrega. Ver tabla valores para Incoterms |
| Observación | Alfanumérico | 100 | Observación. |
| formaPago | numérico | 100 | Código de la DIAN asociado a la forma de pago del documento electrónico. revisar tabla valores para forma de Pago |
| total | numérico | 100 | Valor total del documento electrónico. |
| ítems | Array [] | Lineas de la factura. | |
| items.nombreItemVenta | Alfanumérico | 100 | Nombre del producto vendido |
| items.precioVentaUnitario | numérico | 100 | Precio de venta unitario del producto |
| items.cantidad | numérico | 100 | Cantidad vendida del ítem |
| items.impuesto | Alfanúmerico | 100 | Impuesto aplicado, revisar tabla Valores para impuestos |
| items.código | Alfanumérico | 100 | Código del producto vendido. |
| items.unidad | Alfanumérico | 100 | código de la DIAN de la Unidad del producto. Véase tabla Valores para unidad |
| items.códigoDescuento | Alfanuméricos | 100 | Código de la dian del tipo de descuento aplicado al ítem. |
| items.descuentoPorcentaje | numérico | 100 | porcentaje de descuento aplicado al ítem |
| items.observacion | Alfanumérico | 100 | Observación del ítem |
| numeroResolucion | numérico | 100 | Número de resolucion aprobada en la DIAN |
| códigoDescuento | Alfanumérico | 100 | Código de la DIAN del tipo de descuento aplicado al ítem |
| porcentajeDescuentoGeneral | numérico | 100 | Porcentaje de descuento aplicado al valor total |
| Divisa | Objeto | Datos de la divisa. | |
| divisa.tasaCambio | Numérico | 100 | Valor monetario equivalente |
| divisa.fechaDivisa | Numérico | 100 | Fecha en la cual se tomo el valor de la moneda. |
| divisa.moneda | Alfanumérico | 100 | Código del tipo de moneda, Véase tabla Valores para moneda |
| periodoFacturacion.fechaInicial | String | Fecha de inicio del periodo de facturación en formato YYYY-MM-DD. | |
| periodoFacturacion.horaInicial | String | Hora de la fecha de inicio del periodo de facturación en formato hh:mm:ss | |
| periodoFacturacion.fechaFinal | String | Fecha de inicio del periodo de facturación en formato YYYY-MM-DD | |
| periodoFacturacion.horaFinal | String | Hora de la fecha de finalización del periodo de facturación en formato hh:mm:ss |
| Nombre | Código |
|---|---|
| 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 |
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 |
|---|---|
| Responsable del impuesto sobre las ventas - IVA | IMPUESTO_SOBRE_VENTAS |
| No responsable de IVA | NO_RESPONSABLE_IVA |
| Nombre | código |
|---|---|
| Acuerdo mutuo | ZZZ |
| Efectivo | 10 |
| Consiganción bancaria | 42 |
| Tarjeta crédito | 30 |
| Tarjeta Débito | 49 |
| Bonos | 71 |
| Bookentry Crédito | 15 |
| Bookentry Débito | 16 |
| Cheque | 20 |
| Cheque bancario | 23 |
| Cheque certificado | 25 |
| Cheque Local | 26 |
| Cheque local transferible | 92 |
| Clearing entre partners | 97 |
| Clearing Nacional o Regional | 9 |
| Concentración de la demanda en efectivo / Desembolso (CCD) débito | 18 |
| Concentración de la demanda en efectivo /Desembolso Crédito (CCD) | 17 |
| Concentración Efectivo / Desembolso Crédito plus (CCD+) | 32 |
| Concentración efectivo / Desembolso Débito plus (CCD+) | 43 |
| Concentración Efectivo / Desembolso Débito plus (CCD+) | 33 |
| Concentración efectivo ahorros / Desembolso Crédito (CCD) | 35 |
| Concentración efectivo ahorros / Desembolso Drédito (CCD) | 36 |
| Concentración efectivo/Desembolso Crédito plus (CCD+) | 41 |
| Crédito ACH | 2 |
| Crédito Ahorro | 13 |
| Crédito de demanda ACH | 6 |
| Crédito Negocio Intercambio Corporativo (CTX) | 28 |
| Crédito Negocio Intercambio Corporativo (CTX) | 39 |
| Crédito Pago negocio corporativo (CTP) | 19 |
| Débito ACH | 3 |
| Débito Ahorro | 14 |
| Débito de demanda ACH | 7 |
| Débito Negocio Intercambio Corporativo (CTX) | 40 |
| Débito Negocio Intercambio Corporativo (CTX) | 29 |
| Débito Pago Negocio Corporativo (CTP) | 27 |
| Giro formato abierto | 95 |
| Giro referenciado | 93 |
| Giro urgente | 94 |
| Instrumento no definido | 1 |
| Mantener | 8 |
| Método de pago solicitado no usuado | 96 |
| Nota bancaria transferible | 91 |
| Nota cambiaria | 44 |
| Nota cambiaria esperando aceptación | 24 |
| Nota promisoria | 60 |
| Nota promisoria firmada | 66 |
| Nota promisoria firmada por el acreedor | 61 |
| Nota promisoria firmada por el acreedor, avalada por el banco | 62 |
| Nota promisoria firmada por el acreedor, avalada por un tercero | 63 |
| Nota promisoria firmada por el banco | 64 |
| Nota promisoria firmada por un banco avalada por otro banco | 65 |
| Nota promisoria firmada por un tercero avalada por un banco | 67 |
| Pago comercial urgente | 52 |
| Pago Negocio Corporativo Ahorros Crédito (CTP) | 37 |
| Pago Neogcio Corporativo Ahorros Débito (CTP) | 38 |
| Pago Tesorería Urgente | 53 |
| Pago y depósito pre acordado (PPD) | 34 |
| Postgiro | 50 |
| Poyecto bancario | 21 |
| Proyecto bancario certificado | 22 |
| Retiro de nota por el acreedor | 70 |
| Retiro de nota por el acreedor sobre un banco | 74 |
| Retiro de nota por el acreedor, avalada por otro banco | 75 |
| Retiro de nota por el acreedor, sobre un banco avalada por un tercero | 76 |
| Retiro de una nota por el acreedor sobre un tercero | 77 |
| Retiro de una nota por el acreedor sobre un tercero avalada por un banco | 78 |
| Reversión Crédito Ahorro | 11 |
| Reversión crédito de demanda ACH | 5 |
| Reversión Débito Ahorro | 12 |
| Reversión débito de demanda ACH | 4 |
| Tarjeta Crédito | 48 |
| Tarjeta débito | 31 |
| Telex estándar bancario francés | 51 |
| Transferencia Crédito Bancario | 45 |
| Transferencia Débito Bancaria | 47 |
| Transferencia Débito Interbancario | 46 |
| Vales | 72 |
| Descripción | Código |
|---|---|
| Costo flete | COSTO_FLETE |
| Costo flete seguro | COSTO_FLETE_SEGURO |
| En fabrica | EN_FABRICA |
| Entregado en lugar | ENTREGADO_EN_LUGAR |
| Entregado en terminal | ENTREGADO_EN_TERMINAL |
| Entregado pago derechos | ENTREGADO_PAGO_DERECHOS |
| Entrega lugar descargada | ENTREGADA_LUGAR_DESCARGADA |
| Franco a bordo | FRANCO_A_BORDO |
| Franco costado buque | FRANCO_COSTADO_BUQUE |
| Franco transportista | FRANCO_TRANSPORTISTA |
| Transporte pagado | TRANSPORTE_PAGADO |
| Transporte seguro pagado | TRANSPORTE_SEGURO_PAGADO |
| Nombre | código |
|---|---|
| contado | 1 |
| Crédito | 2 |
| Nombre del campo | código |
|---|---|
| Unidad | 94 |
| Pieza | 94 |
| Centímetro | CMT |
| Metro | MTR |
| Pulgada | INH |
| Centímetro cuadrado | CMK |
| Metro cuadrado (m2) | MTK |
| Pulgada cuadrada | INK |
| Mililitro | MLT |
| Litro | LTR |
| Galón | A76 |
| Gramo | GGR |
| Kilogramo | KGM |
| Tonelada | 54 |
| Libra | LBR |
| Servicio | 94 |
| Centímetro Cúbico (cm3) | CMQ |
| Metro Cúbico | MTQ |
| Nombre | código |
|---|---|
| Descuento por impuesto asumido | 00 |
| Pague uno lleve otro | 01 |
| Descuentos contractulales | 02 |
| Descuento por pronto pago | 03 |
| Envío gratis | 04 |
| Descuentos específicos por inventarios | 05 |
| Descuento por monto de compras | 06 |
| Descuento de temporada | 07 |
| Descuento por actualización de productos / servicios | 08 |
| Descuento general | 09 |
| Descuento por volumen | 10 |
| Otro descuento | 11 |
| Descripción | código |
|---|---|
| Excluido de impuesto | EXCLUIDO |
| Exento de impuesto | EXENTO |
| Impuesto al consumo 4% | IMPUESTO_CONSUMO_4 |
| Impuesto al consumo 8% | IMPUESTO_CONSUMO_8 |
| Impuesto al consumo 16% | IMPUESTO_CONSUMO_16 |
| IVA 5% | IVA_5 |
| IVA 19% | IVA_19 |
| Código naturaleza | Descripción |
|---|---|
| NATURALES | Persona natural |
| JURIDICAS | Persona Jurídica |
| Código | Descripción |
|---|---|
| COP | Pesos |
| USD | Dólar |
| EUR | Euro |
| Revisar el servicio Web para conocer los datos de las ciudades |
| Nombre | Código |
|---|---|
| Arrendamiento de bienes inmuebles (declarantes) | 1 |
| Compras generales (declarantes) | 3 |
| Compras generales (no declarantes) | 4 |
| Honorarios y comisiones (no declarantes)) | 5 |
| Honorarios y comisiones (personas jurídicas) | 6 |
| Servicios de aseo y vigilancia | 7 |
| Servicios de hoteles y restaurantes (no declarantes) | 8 |
| Servicios generales (declarantes) | 9 |
| Servicios generales (no declarantes) | 10 |
| ReteICA | 11 |
| ReteIVA 15% | 12 |
| Transporte de Carga | 13 |
| ReteIVA 100% | 16 |
| Arrendamiento de bienes inmuebles (no declarantes) | 17 |
| Arrendamiento de bienes muebles | 18 |
| Compras con tarjeta débito o crédito | 19 |
| Compras de bienes o productos agrícolas o pecuarios sin procesamiento industrial | 20 |
| Compras de bienes o productos agrícolas o pecuarios con procesamiento industrial (declarantes) | 21 |
| Compras de bienes o productos agrícolas o pecuarios con procesamiento industrial declarantes (no declarantes) | 22 |
| Compras de café pergamino o cereza | 23 |
| Compras de combustibles derivados del petróleo | 24 |
| Enajenación de activos fijos de personas naturales (notarías y tránsito son agentes retenedores) | 25 |
| Compras de vehículos | 26 |
| Compras de bienes raíces cuya destinación y uso sea vivienda de habitación (por las primeras 20.000 UVT, es decir hasta $637.780.000) | 27 |
| Compras de bienes raíces cuya destinación y uso sea vivienda de habitación (exceso de las primeras 20.000 UVT, es decir superior a $637.780.000) | 28 |
| Compras de bienes raíces cuya destinación y uso sea distinto a vivienda de habitación | 29 |
| Por emolumentos eclesiásticos (declarantes) | 30 |
| Por emolumentos eclesiásticos (no declarantes) | 31 |
| Servicios de transporte de carga | 32 |
| Servicios de transporte nacional de pasajeros por vía terrestre (declarantes) | 33 |
| Servicios de transporte nacional de pasajeros por vía terrestre (no declarantes) | 34 |
| Servicios de transporte nacional de pasajeros por vía aérea o marítima/td> | 35 |
| Servicios prestados por empresas de servicios temporales (sobre AIU) | 36 |
| Servicios prestados por empresas de vigilancia y aseo (sobre AIU) | 37 |
| Servicios integrales de salud prestados por IPS | 38 |
| Servicios de hoteles y restaurantes (declarantes) | 39 |
| Otros ingresos tributarios (declarantes) | 40 |
| Otros ingresos tributarios (no declarantes) | 41 |
| Honorarios y comisiones personas naturales que suscriban contrato o cuya sumatoria de los pagos o abonos en cuenta superen las 3.300 UVT ($105.135.000) | 42 |
| Servicios de licenciamiento o derecho de uso de software | 43 |
| Intereses o rendimientos financieros | 44 |
| Rendimientos financieros provenientes de títulos de renta fija | 45 |
| Loterías, rifas, apuestas y similares | 46 |
| Retención en colocación independiente de juegos de suerte y azar | 47 |
| Contratos de construcción y urbanización | 48 |
Respuesta:
| Nombre | Tipo dato | Descripción |
|---|---|---|
| success | Booleano | Determina si la operación fué exitosa o no |
| titleResponse | Alfanumérico | Título de la respuesta |
| textResponse | Alfanumérico | Texto de la respuesta |
| lastAction | Alfanumérico | Nombre de la acción bajo la cual se respondió esta respuesta |
| data | Datos de respuesta | |
| data.numeroFactura | Alfanúmerico | Número de la factura creada |
| data.urlAcuseRecibido | Alfanúmerico | URL para acusar recibido de la información |
| data.cufe | Alfanumérico | Cufe de la Factura electrónica creada |
| errores | Alfanumérico | Detalles globales de errores. |
| total_errores | Numérico | Número total de errores |
| errores.errores | Array | Array, con la lista de errores. |
| errores.errores.codError | Alfanúmerico | Código de error. |
| errores.errores.errorMessage | Alfanúmerico | Mensaje del error. |
En caso de que no se pueda obtener la información de la factura se debe tener en cuenta la variable success y los valores detitleResponse y textResponse para poder mostrar los mensajes respectivos al usuario. La variable titleResponse contiene el código del error y la variable textResponse contiene la descripción del error la cual debe ser mostrada al usuario. Si es errores por validación de datos en data se retorna el total de errores y un array con los errores.
Correcto
En caso de que la petición se ejecute sin errores se devolverá la siguiente respuesta:
CÓDIGO HTTP: 200
Error
Si la solicitud no es correcta, recibirá la siguiente respuesta:
CÓDIGO HTTP: 400 | 401 | 500