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ónicatipo 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.
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+)
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ÓDIGOHTTP: 200
Error
Si la solicitud no es correcta, recibirá la siguiente respuesta:
Crear Factura electrónica Exportación
Correcto
Error