EndPoint

Método: POST

EndPoint:


						Pruebas 

						https://servicios-pruebas.afacturar.com/api/doc_equivalente/juegos_localizados


						Habilitación 

						https://servicios-habilitacion.afacturar.com/api/doc_equivalente/juegos_localizados


						Producción 

						https://servicios.afacturar.com/api/doc_equivalente/juegos_localizados

Seguridad SSL: Afacturar cuenta en sus endpoint con certificados de seguridad (DigiCert SHA2 Extended Validation Server CA), su aplicación debe ser capaz de negociar y validar dicho certificado.

Parámetros de entrada

HEADERS

Accept: application/json

Authorization: Bearer Token asignado a cada cliente

BODY

documento_obligado: Número de identificación del cliente

data: JSON

testSetId: Número entregado en la DIAN para la Habilitación. Este parametro es soló para habilitación

Estructura de JSON de entrada

DEE - Juegos localizados

facturas Objeto Requerido

Información de la factura

Especificación:

encabezado Objeto Requerido

Encabezado

Especificación:

id_factura

String

Requerido

Número de documento: Número de factura o factura cambiaria. Consecutivo de factura autorizados por la DIAN

Especificación: No se permiten caracteres adicionales como espacios o guiones.

fecha

Date

Requerido

Fecha de emisión de la factura a efectos fiscales.Validar que la fecha del documento no sea inferior a 5 días calendario y no superior a 10 días calendario.

Especificación: AAAA-MM-DD

hora

Time

Requerido

Hora de emisión de la factura

Especificación: HH24:MM:SS

nota Array Requerido

Las notas se van a distribuir en un formato similar a JSON, en el cual se cambia la comilla doble por sencilla, tanto en el nombre de la variable, como en su valor, esto debido a la restricción de algunos caracteres especiales que no son soportados en este campo.

Este JSON termina siendo un STRING que se debe enviar dividido en las posiciones del array de nota, de acuerdo con las restricciones que defina la DIAN:

A la fecha (2019-01-11) existe una restricción de enviar como mínimo 15 caracteres(*)

La estructura a utilizar es:

{'variable_1': 'valor_1', 'variable_2':'valor_2'}

Ejemplos:

Enviar valores nulos o vacíos

nota[0] = "{‘variable_1': 'null', 'variable_2':'valor_2', 'variable_3':''}"

División del STRING en varias posiciones del array

nota[0] = "{‘variable_1': 'null', 'variab"

nota[1] = "le_2':'valor_2', 'variable_3':''}"

El API genera la concatenación del STRING y lo convierte a formato JSON y realiza la respectiva validación.

Hay que tener en cuenta que los caracteres (comilla sencilla, backslash, backslash comilla sencilla ) no se deben enviar, porque no son soportados en el API.

Si alguna variable es diferente a las del listado de especificaciones, se debe consultar con el personal de operación de Teleinte S.A.S, para realizar la respectiva validación, y en caso que no exista una variable, se estudiará el caso para determinar la adición o no de la variable que cumpla con la Descripcion requerida.

(*) Estas restricciones pueden cambiar en cualquier momento por parte de la DIAN, de acuerdo al nuevo proceso que estandarización y validación que están estableciendo.

Especificación: El listado de la estandarización de las variables se puede ver aqui

moneda

Parametrizado

Requerido

Divisa aplicable a toda la factura

Especificación: COP- Colombia, USD - dolares. Inf adicional Ver

tipo_operacion

Parametrizado

Requerido

Tipo de operacion

Especificación:

321 = Reporte diario

322 = Reporte diario final

numero_orden

String

No_requerido

Número de orden

Especificación: Mínimo 3 caracteres

servicio

Objeto

Requerido

Datos del servicio de juegos localizados

Especificación:

punto_de_juego

Objeto

Requerido

Información de la sala o establecimiento

Especificación:

tipo

Parametrizado

Requerido

Tipo de establecimiento fisico o virtual

Especificación:

FISICO

VIRTUAL

ubicacion

String

Requerido

Dirección de establecimiento o dirección de internet e IP cuando es virtual

Especificación: Mínimo 2 caracteres.

valor_deposito

String

Requerido

Valor de la base o depósito de dinero

Especificación: Mínimo 2 caracteres

datos_juego

Array

Requerido

Información del juego

Especificación:

tipo

String

Requerido

Tipo de juego de suerte o azar.Indicar alguno de los literales 'Mesa', 'Bingo', 'Boleta', 'Fracción' o 'formulario'

Especificación: Mínimo 2 caracteres

cantidad_maquinas

String

Requerido

Números de máquinas autorizadas por COLJUEGOS por cada tipo de máquina

Especificación: Mínimo 2 caracteres.

credito_diario

Array

Requerido

Información del valor diario crédito de un instrumento de juego

Especificación:

serial_maquina

String

Requerido

Número del serial de la máquina o instrumento de juego con reporte diario crédito

Especificación: Mínimo 2 caracteres

valor_credito

String

Requerido

Valor crédito de la máquina o instrumento de juego

Especificación: Mínimo 2 caracteres.

moneda

Parametrizado

Requerido

Divisa aplicabla

Especificación: COP- Colombia, USD - dolares. Inf adicional Ver

formas_de_pago

Array

No_Requerido

Formas de pago

Especificación:

metodo_de_pago

Parametrizado

Requerido

Método de pago

Especificación:

1 = Contado

2 = Crédito

tipo_de_pago

Parametrizado

Requerido

Código correspondiente al medio de pago

Especificación:

10 = Efectivo

42 = Consignación bancaria

20 = Cheque

Inf adicional Ver
Se elimino el codigo (8) Mantener, se adicionaron los codigos (71) Bonos y (72) Vales.

identificador_de_pago

String

No_requerido

Identificador de pago o número de referencia de pago

Especificación:

fecha_vencimiento

Date

No_requerido

Fecha de vencimiento. Obligatorio si el método de pago es crédito

Especificación: AAAA-MM-DD

detalle_factura

Objeto

Requerido

Detalles de la factura

Especificación:

numero_linea

Numerico

Requerido

Número de Línea

Especificación: 1...n

cantidad

Numerico

Requerido

(Cant) Cantidad de productos o servicios solicitados. Número de unidades servidas/prestadas.

Especificación: ...n

unidad_de_cantidad

Parametrizado

Requerido

Unidad de la cantidad del artículo solicitiado

Especificación:

94 => Unidad

LBR => Libra

LTR => Litro

MIN => Minuto

Inf adicional Ver

valor_unitario

String-patron

Requerido

(VU) Es el precio por unidad de cada bien o servicio antes de aplicar los impuestos o descuento. El valor base es el precio de un activo fijo a efectos impositivos. El valor base es el precio base de un activo sobre el cual se calcula la depreciación y la amortización

Especificación: Separador con punto, hasta seis decimales

descripcion

String

Requerido

Descripcion del artículo o servicio a que se refiere esta línea de la factura

Especificación: Mínimo de 2 caracteres

nota_detalle

String

Requerido

Información adicional: Texto libre, relativo al documento. Para el caso de facturas por contratos de servicio tipo AIU, se debe enviar incluir el objeto del contrato facturado

Especificación: Mínimo de 2 caracteres

marca

String

Requerido

Marca: Marca del artículo

Especificación:

modelo

String

Requerido

Modelo: Modelo del artículo

Especificación:

codificacion_estandar

Objeto

No_requerido

Identificación del producto o servicio de acuerdo con un estandar acordado por la industria, los cuales facilitan el comercio entre empresas y gobierno.

Especificación:

cod_grupo_bien_servicio

Parametrizado

Requerido

Tipo de estandar de codificación utilizado para la clasificación de los productos o servicios.

UNSPSC - United Nations Standard Products and Services Code® - Código Estándar de Productos y Servicios de Naciones Unidas. Ver documentación

GTIN - Números Globales de Identificación de Productos.Estructura de los códigos GTIN:

GS1 - Guía de Identificación. Ver documentación

GTIN 14 - Identificación Unidades Logísticas. Ver documentación

999 - Códigos libres o autónomosCorresponden a la codificación que las empresas cuentan en sus sistemas para la identificación inequívoca de los bienes o servicios que prestan.

Especificación:

1 -> UNSPSC

10 -> GTIN

20 -> Partida Arancelarias

999 -> Estándar de adopción del contribuyente

nombre_grupo_bien_servicio

Parametrizado

Requerido

Nombre de la codificación utilizada para la clasificación de los productos o servicios

Especificación:

UNSPSC -> 1

GTIN -> 10

Partida Arancelarias -> 20

Estándar de adopción del contribuyente -> 999

cod_segmento_bien_servicio

String

Requerido

Codigo del segmento.

Especificación: Dependen del grupo del bien o servicio. Información adicional Ver

cod_bien_servicio

String

Requerido

Codigo del bien o servicio

Especificación: Dependen del segmento del bien o servicio. Información adicional Ver

regalo

Objeto

Requerido

Indicador de si el ítem es gratuito o no

Especificación:

es_regalo

Boolean

Requerido

Describe si el articulo es un regalo o muestra comercial

Especificación: true o false

cod_precio_referencia

Parametrizado

Requerido

Código del tipo de precio informado

Especificación:

1 = Valor comercial

0 = En el caso que no sea regalo

Se eliminaron los codigos (2) Valor en inventarios y (3) Otro valor

precio_referencia

String-patron

Requerido

Precio de referencia para línea que no contienen valor comercial.

Especificación: Separador con punto, hasta seis decimales

cargo_descuento

Objeto

Requerido

Información relacionada con un cargo o un descuento

Especificación:

es_descuento

Boolean

Requerido

Indica que el elemento es un Cargo y no un descuento

Descuento es true cuando es un descuento, un Crédito descuenta el valor del ítem

Cargo es false cuando es un recargo, es un Débito aumenta el valor del item.

Especificación: True o false

porcentaje_cargo_descuento

String-patron

Requerido

Porcentaje de descuento o cargo a la linea de la factura

Especificación: Separador con punto, hasta seis decimales

valor_base_cargo_descuento

String-patron

Requerido

Valor Base para calcular el descuento o el cargo

Especificación: Separador con punto, hasta seis decimales

valor_cargo_descuento

String-patron

Requerido

Valor del descuento o el cargo

Especificación: Separador con punto, hasta seis decimales

impuestos_detalle

Objeto

Requerido

Información relacionada con el impuesto aplicado a la linea de detalle

Especificación:

codigo_impuesto

Parametrizado

Requerido

Identificador del tributo

Especificación:

1= IVA

2= Impuesto al consumo

3= ICA

4= Impuesto nacional al consumo

0= Excluido de IVA

porcentaje_impuesto

String-patron

Requerido

Tarifa del tributo. Porcentaje del valor tributable a ser aplicada a la base imponible de la linea de detalle. Si el item es excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, hasta seis decimales. Información adicional Ver

valor_base_impuesto

String-patron

Requerido

(VU-VD)*Cant). Base Imponible sobre la que se calcula el valor del tributo. Si el item es excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, hasta seis decimales

valor_impuesto

String-patron

Requerido

(((VU-VD)*Cant) * %Imp). Valor del tributo: producto del porcentaje aplicado sobre la base imponible.Si el item es excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, hasta seis decimales

otros_impuestos

Array

No_Requerido

Información relacionada con los impuestos de valor fijo por unidad tributada

Especificación:

codigo_impuesto

Parametrizado

Requerido

Identificador del tributo

Especificación:

20= FtoHorticultura

21= Impuesto de Timbre

22= Impuesto Nacional al Consumo de Bolsa Plástica

23= Impuesto Nacional del Carbono

24= Impuesto Nacional a los Combustibles

25= Sobretasa a los combustibles

35= Impuesto a los productos comestibles ultraprocesados industrialmente y/o con alto contenido de azúcares añadidos, sodio o grasas saturadas

unidad_de_medida

Parametrizado

Requerido

Unidad de medida del artículo solicitiado

Especificación:

94 => Unidad

LBR => Libra

LTR => Litro

MIN => Minuto

Inf adicional Ver

nombre_impuesto

String

Requerido

Nombre del tributo.

Especificación: Se recomienda enviar los siguientes valores.

20= FtoHorticultura

21= Timbre

22= INC Bolsas

23= INCarbono

24= INCombustibles

25= Sobretasa Combustibles

porcentaje_impuesto

String-patron

Requerido

Tarifa del tributo. Porcentaje del valor tributable a ser aplicada a la base imponible de la linea de detalle. S

Especificación: Separador con punto, hasta seis decimales. Este impuesto del 10% sera por el año 2023 de acuerdo a la tarifa y se cobra sobre el valor total de la linea de producto

valor_base_impuesto

String-patron

Requerido

Base Imponible sobre la que se calcula el valor del tributo.

Especificación: Separador con punto, hasta seis decimales

valor_impuesto_por_unidad

String-patron

Requerido

Valor del tributo por unidad .

Especificación: Separador con punto, hasta seis decimales

valor_impuesto

String-patron

Requerido

(Cant * Valor de impuesto por unidad). Valor del tributo.

Especificación: Separador con punto, hasta seis decimales

retenciones_detalle

Objeto

Requerido

Información relacionada con los tributos retenidos en la linea de detalle

Especificación:

codigo

Parametrizado

Requerido

Identificador de las retenciónes

Especificación:

5= ReteIVA

6= ReteFuente

7= ReteICA

0= No tiene retenciónes

porcentaje

Parametrizado ReteFuente - ReteIVA

String patron decimal

Requerido

Tarifa del tributo retenido. Porcentaje del valor tributable retenido a ser aplicada a la base imponible de la linea de detalle.

Especificación: Separador con punto, hasta seis decimales. Información adicional Ver

valor_base

String-patron

Requerido

La base gravable es el valor sobre el cual se aplica la tarifa de la retención

Especificación: Separador con punto, hasta seis decimales

valor_retenido

String-patron

Requerido

Valor del tributo: producto del porcentaje aplicado sobre la base imponible

Especificación: Separador con punto, hasta seis decimales

valor_total_detalle_con_cargo_descuento

String-patron

Requerido

(((VU * Cant)- VD)+VR). Valor total de la linea de detalle incluyendo el descuento y el recargo si aplica

Especificación: Separador con punto, hasta seis decimales

valor_total_detalle

String-patron

Requerido

(VU*Cant). Valor total de la linea de detalle sin incluir descuentos, retenciónes o impuestos.

Especificación: Separador con punto, hasta seis decimales

informacion_adicional

Array

No_Requerido

Caracteristicas adicionales al detalle

Especificación:

variable

String

Requerido

Nombre del elemento a informar

Especificación:

DESCRIPCION => Otra descripción del item

valor

String

Requerido

Valor del elemento a informar

Especificación:

impuestos

Objeto

Requerido

Impuestos

Especificación:

codigo_impuesto

Parametrizado

Requerido

Es la clase que se utiliza para describir el esquema del impuesto

Especificación:

01= IVA

02= Impuesto al consumo

03= ICA

04= Impuesto nacional al consumo

0= Excluido de IVA

porcentaje_impuesto

String-patron

Requerido

Número de importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, hasta seis decimales. Información adicional Ver

valor_base_calculo_impuesto

String-patron

Requerido

Base Imponible sobre la que se calcula la retención de impuesto. Si hay algun item excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, hasta seis decimales

valor_total_impuesto

String-patron

Requerido

Importe del impuesto retenido. Si hay algun item excluido de IVA debe ir en 0.00.

Especificación: Separador con punto, hasta seis decimales

otros_impuestos

Array

No_Requerido

Información relacionada con los impuestos de valor fijo por unidad tributada

Especificación:

codigo_impuesto

Parametrizado

Requerido

Identificador del tributo

Especificación:

20= FtoHorticultura

21= Impuesto de Timbre

22= Impuesto Nacional al Consumo de Bolsa Plástica

23= Impuesto Nacional del Carbono

24= Impuesto Nacional a los Combustibles

25= Sobretasa a los combustibles

35= Impuesto a los productos comestibles ultraprocesados industrialmente y/o con alto contenido de azúcares añadidos, sodio o grasas saturadas

unidad_de_medida

Parametrizado

Requerido

Unidad de medida del artículo solicitiado

Especificación:

94 => Unidad

LBR => Libra

LTR => Litro

MIN => Minuto

Inf adicional Ver

nombre_impuesto

String

Requerido

Nombre del tributo.

Especificación: Se recomienda enviar los siguientes valores.

20= FtoHorticultura

21= Timbre

22= INC Bolsas

23= INCarbono

24= INCombustibles

25= Sobretasa Combustibles

porcentaje_impuesto

String-patron

Requerido

Tarifa del tributo. Porcentaje del valor tributable a ser aplicada a la base imponible de la linea de detalle. S

Especificación: Separador con punto, hasta seis decimales. Este impuesto del 10% sera por el año 2023 de acuerdo a la tarifa y se cobra sobre el valor total de la linea de producto

valor_base_impuesto

String-patron

Requerido

Base Imponible sobre la que se calcula el valor del tributo.

Especificación: Separador con punto, hasta seis decimales

valor_impuesto_por_unidad

String-patron

Requerido

Valor del tributo por unidad .

Especificación: Separador con punto, hasta seis decimales

valor_total_impuesto

String-patron

Requerido

Valor total del tributo.

Especificación: Separador con punto, hasta seis decimales

retenciones

Objeto

Requerido

Retenciones

Especificación:

codigo

Parametrizado

Requerido

Identificador de las retenciónes

Especificación:

5= ReteIVA

6= ReteFuente

7= ReteICA

0= No tiene retenciónes

porcentaje

Parametrizado

Requerido

Importe del impuesto retenido al total de la factura

Especificación: Separador con punto, hasta seis decimales. Información adicional Ver

valor_base

String-patron

Requerido

La base gravable es el valor sobre el cual se aplica la tarifa de la retención

Especificación: Separador con punto, hasta seis decimales

valor_retenido

String-patron

Requerido

Valor total de la retención por factura

Especificación: Separador con punto, hasta seis decimales

recargos

Objeto

Requerido

Recargos

Especificación:

nombre_recargo

String

Requerido

Especificación: Mínimo 3 caracteres

porcentaje_recargo

String-patron

Requerido

Especificación: Separador con punto, hasta seis decimales

valor_base_calculo_recargo

String-patron

Requerido

Especificación: Separador con punto, hasta seis decimales

valor_total_recargo

String-patron

Requerido

Especificación: Separador con punto, hasta seis decimales

descuentos

Objeto

Requerido

Descuentos

Especificación:

codigo_descuento

Parametrizado

Requerido

Numero utilizado para categorizar el tipo de descuento otorgado

Especificación:

01= Descuento condicionado

99= No aplica descuento

Se eliminaron los codigos: (00) Descuento por impuesto asumido. (02) Descuentos contractulales. (03) Descuento por pronto pago. (04) Envío gratis. (05) Descuentos escpecíficos por inventarios. (06) Descuento por monto de compras. (07) Descuento de temporada. (08) Descuento por acturalización de productos / servicios. (09) Descuento general. (10) Descuento por volumen. (11) Otro descuento.

porcentaje_descuento

String-patron

Requerido

Número del descuento

Especificación: Separador con punto, hasta seis decimales

valor_base_calculo_descuento

String-patron

Requerido

Valor Base para calcular el descuento

Especificación: Separador con punto, hasta seis decimales

valor_total_descuento

String-patron

Requerido

Valor total del descuento

Especificación: Separador con punto, hasta seis decimales

valor_factura

Objeto

Requerido

Valor factura

Especificación:

valor_base

String-patron

Requerido

Total Valor Bruto antes de tributos: Total valor bruto, suma de los valores brutos de las líneas de la factura incluyendo descuentos mas recargos, es decir la suma de todas las lineas de detalle de los valor_total_detalle_con_cargo_descuento.

Especificación: Separador con punto, hasta seis decimales

valor_base_calculo_impuestos

String-patron

Requerido

Total Valor Base Imponible : Base imponible para el cálculo de los tributos

tiene que ser la suma de los valores de las bases imponibles de todas líneas de detalle

Especificación: Separador con punto, hasta seis decimales

valor_base_mas_impuestos

String-patron

Requerido

Total de Valor Bruto más tributos

El Valor Bruto más tributos tiene que ser igual a Valor Bruto de la factura que contienen el valor comercial más la Suma de los Tributos de todas las líneas de detalle.

Especificación: Separador con punto, hasta seis decimales

valor_anticipo

String-patron

Requerido

Valor que el cliente pago por adelantado a cuenta de una futura compra

Especificación: Separador con punto, hasta seis decimales

valor_descuento_total

String-patron

Requerido

Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura

El Valor del Descuento Total es igual a la Suma de todos los descuentos globales aplicados al total de la factura.

Especificación: Separador con punto, hasta seis decimales

valor_total_impuesto_1

String-patron

Requerido

Suma de todos los impuestos 1 aplicados a nivel de las lineas de detalle

Especificación: Separador con punto, hasta seis decimales

valor_total_impuesto_2

String-patron

Requerido

Suma de todos los impuestos 2 aplicados a nivel de las lineas de detalle

Especificación: Separador con punto, hasta seis decimales

valor_total_impuesto_3

String-patron

Requerido

Suma de todos los impuestos 3 aplicados a nivel de las lineas de detalle

Especificación: Separador con punto, hasta seis decimales

valor_total_impuesto_4

String-patron

Requerido

Suma de todos los impuestos 4 aplicados a nivel de las lineas de detalle

Especificación: Separador con punto, hasta seis decimales

valor_total_reteiva

String-patron

Requerido

Suma de todos los reteiva a nivel de las lineas de detalle

Especificación: Separador con punto, hasta seis decimales

valor_total_retefuente

String-patron

Requerido

Suma de todos los retefuente a nivel de las lineas de detalle

Especificación: Separador con punto, hasta seis decimales

valor_total_reteica

String-patron

Requerido

Suma de todos los reteica a nivel de las lineas de detalle

Especificación: Separador con punto, hasta seis decimales

valor_total_factura

String-patron

Requerido

Valor Total de factura: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems)+valor de impuestos + valor cargos – valor descuentos

El Valor a total de Factura es igual a la Suma de Valor Bruto más tributos - Valor del Descuento Total + Valor del Cargo Total

Especificación: Separador con punto, hasta seis decimales

valor_total_a_pagar

String-patron

Requerido

Valor total a pagar: El valor a total de factura es igual a la suma de valor bruto + impuestos - retenciónes - valor del descuento total + valor del cargo total - valor del anticipo total

Especificación: Separador con punto, hasta seis decimales

generalidades

Objeto

Requerido

Generalidades

Especificación:

tipo_ambiente_dian

Parametrizado

Requerido

Ambiente de la DIAN al que se destina el documento enviado.

Especificación:

1= Producción

2= Pruebas

version

Numerico

Requerido

Identificación consecutiva de la especificación

Especificación:

identificador_transmision

String

Requerido

Código único para identificar el paquete transmitido

Especificación: Mínimo 5 caracteres

integrador

Objeto

Requerido

Información de quien envia la información

Especificación:

nombre

Parametrizado

Requerido

Nombre de quien realiza la integración

Especificación: S o N

tipo

Parametrizado

Requerido

Codigo del medio usado para realizar la integración

Especificación:

MOVIL

WEB

DLL

EXCEL

ERP-XXXXXXXXX

webhook

String

No_requerido

URL para notificar cuando ha ocurrido un evento. Esta se utiliza cuando los codigos de error del retorno del API son 28,20.

Especificación: URL con portocolo de seguridad - HTTPS

fabricante_software

Objeto

Requerido

Datos del fabricante de software

Especificación:

nombre_apellido

String

Requerido

Nombres y apellidos del fabricante del software

Especificación: Mínimo 3 caracteres

razon_social

String

Requerido

Razon social del fabricante del software)

Especificación: Mínimo 3 caracteres

nombre_software

String

Requerido

Nombre del Software

Especificación: Mínimo 3 caracteres

Estructura json


														{
	"facturas": [
		{
			"encabezado": {
				"id_factura": "",
				"fecha": "",
				"hora": "",
				"nota": [
					"{'':''",
					"'':''}"
				],
				"moneda": "",
				"tipo_operacion": "",
				"numero_orden": ""
			},
			"servicio": {
				"punto_de_juego": {
					"tipo": "",
					"ubicacion": "",
					"valor_deposito": ""
				},
				"datos_juego": {
					"tipo": "",
					"cantidad_maquinas": ""
				},
				"credito_diario": {
					"serial_maquina": "",
					"valor_credito": "",
					"moneda": ""
				}
			},
			"formas_de_pago": [
				{
					"metodo_de_pago": "",
					"tipo_de_pago": "",
					"identificador_de_pago": "",
					"fecha_vencimiento": ""
				}
			],
			"detalle_factura": [
				{
					"numero_linea": "",
					"cantidad": "",
					"unidad_de_cantidad": "",
					"valor_unitario": "",
					"descripcion": "",
					"regalo": {
						"es_regalo": "",
						"cod_precio_referencia": "",
						"precio_referencia": ""
					},
					"cargo_descuento": {
						"es_descuento": "",
						"porcentaje_cargo_descuento": "",
						"valor_base_cargo_descuento": "",
						"valor_cargo_descuento": ""
					},
					"impuestos_detalle": {
						"codigo_impuesto": 1,
						"porcentaje_impuesto": "",
						"valor_base_impuesto": "",
						"valor_impuesto": ""
					},
					"retenciones_detalle": [
						{
							"codigo": "",
							"porcentaje": "",
							"valor_base": "",
							"valor_retenido": ""
						}
					],
					"valor_total_detalle_con_cargo_descuento": "",
					"valor_total_detalle": ""
				}
			],
			"impuestos": [
				{
					"codigo_impuesto": "",
					"porcentaje_impuesto": "",
					"valor_base_calculo_impuesto": "",
					"valor_total_impuesto": ""
				}
			],
			"retenciones": [
				{
					"codigo": "",
					"porcentaje": "",
					"valor_base": "",
					"valor_retenido": ""
				}
			],
			"recargos": [
				{
					"nombre_recargo": "",
					"porcentaje_recargo": "",
					"valor_base_calculo_recargo": "",
					"valor_total_recargo": ""
				}
			],
			"descuentos": [
				{
					"codigo_descuento": "",
					"porcentaje_descuento": "",
					"descripcion_descuento": "",
					"valor_base_calculo_descuento": "",
					"valor_total_descuento": ""
				}
			],
			"valor_factura": {
				"valor_base": "",
				"valor_base_calculo_impuestos": "",
				"valor_base_mas_impuestos": "",
				"valor_descuento_total": "",
				"valor_total_recargos": "",
				"valor_total_impuesto_1": "",
				"valor_total_impuesto_2": "",
				"valor_total_impuesto_3": "",
				"valor_total_impuesto_4": "",
				"valor_total_reteiva": "",
				"valor_total_retefuente": "",
				"valor_total_reteica": "",
				"total_factura": "",
				"valor_total_a_pagar": ""
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": "",
		"version": "",
		"identificador_transmision": "",
		"fabricante_software": {
			"nombre_apellido": "",
			"razon_social": "",
			"nombre_software": ""
		}
	}
}

Estructura JSON de respuesta

Salida Exitosa


{
	"codigo_error": 0,
	"descripcion_error": "OK",
	"tiempo_ejecucion": 2.8475100994110109,
	"transaccion": "5e5e5e5e5e55e",
	"resultado": {
		"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
		"id_factura": "SETP990001502",
		"url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
		"qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
		"url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
		"url_application_response": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ar083002047005520SETP990001502.xml",
		"url_attached_document_url": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/ad083002047005520SETP990001502.xml",
		"url_representacion_grafica": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.pdf",
		"url_notificacion_aceptacion_rechazo": "http://app.afacturar.com/consulta_documento/?uid=5e5e5e5e5e55e"
	},
	"entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
	"ErrorMessage_DIAN": ""
}

Salida con errores de semantica


{
    "codigo_error": 400,
    "descripcion_error": "Hay un problema con la informacion entregada",
    "tiempo_ejecucion": 0.01330113410949707,
    "transaccion": "5e74ce82707f6",
    "resultado": [
        {
            "propiedad": "facturas[0].encabezado.tipo_factura",
            "descripcion": "The property tipo_factura is required"
        },
        {
            "propiedad": "facturas[0].encabezado.tipo_factura",
            "descripcion": "Does not have a value in the enumeration [1,2,3,5,6,7,8,9,10]"
        },
        {
            "propiedad": "facturas[0].encabezado",
            "descripcion": "The property tipo_factur is not defined and the definition does not allow additional properties"
        }
    ],
    "entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
    "ErrorMessage_DIAN": ""
}

Salida con errores de datos


{
    "codigo_error": 400,
    "descripcion_error": "Hay problema(s) con la información entregada",
    "resultado": [
        [
            {
                "propiedad": "facturas->encabezado-> numero_resolucion_facturacion y  facturas->encabezado-> prefijo",
                "descripcion": "No exiten rangos de facturación para la resolución SET + 18760000001 "
            },
            {
                "propiedad": "facturas->fecha_vencimiento",
                "descripcion": "Si el metodo de pago es contado, la fecha de vencimiento debe ir vacia"
            }
        ]
    ]
}

Salida con errores HTTP


{
	"codigo_error": 500,
	"descripcion_error": "Unauthenticated."
}

Salida con error de datos en la DIAN


{
    "codigo_error": 15,
    "descripcion_error": "La validación en la DIAN devuelve error(es)",
    "tiempo_ejecucion": 1.9776690006256104,
    "transaccion": "5e74d144dd565",
    "resultado": {
		"cufe": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
		"id_factura": "SETP990001504",
        "url_representacion_qr_svg": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.svg",
        "qr_url_imagen_base_64": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/QR64_111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111.txt",
        "url_representacion_xml": "https://afacturar.archivamos.com/XXXXXXXX/123123123123123123123123123123123123112/AAAA/MM/DD/fv083002047005520SETP990001502.xml",
    },
    "entorno": "Este documento se envia al entorno: DOCUMENTO_NO_VALIDO",
    "ErrorMessage_DIAN": "Regla: FAU06, Rechazo: Valor Bruto más tributos es diferente a Valor Bruto de la factura que contienen el valor comercial más la Suma de los Tributos de todas las líneas de detalle.Regla: FAU02, Rechazo: El Valor Bruto antes de tributos no es igual a la suma de los valores de las líneas de la factura que contienen el valor comercial"
}

Codigo de respuesta

Cuando usted hace un llamado a la API, puede recibir los siguientes mensajes de error en la respuesta. Puede que haya algo mal con su solicitud o puede que algo esté mal de nuestra parte. Los errores responden con un código de error y JSON que contiene un mensaje, una descripción y un código API más preciso.

Códigos de ERROR

Tabla de Errores

Código	Estado	Descripción	Acción sugerida
28	Timeout	La operación duro más de 60 seg
15	Error retornado por la DIAN	La información enviada no cumple con el estandar del XML o los valores no estan bien calculados
400	Solicitud incorrecta	Hay un problema con su solicitud	Compruebe que su solicitud sigue la documentación de la API y utiliza la sintaxis correcta.
401	No autorizado	No tiene la autorización necesaria para realizar la solicitud.	Asegúrese de estar utilizando una clave API válida con los permisos necesarios para su solicitud.
403	Prohibido	El servidor entendió la solicitud, pero se negó a cumplirla.	Vea si su plan en Afacturar.com incluye el recurso que está solicitando y su clave API tiene las autorizaciones necesarias.
404	No encontrado	El servidor no pudo encontrar el recurso solicitado.	Cambie su URL de solicitud para que coincida con un punto final API válido.
405	Método no permitido	El recurso no tiene el método especificado. (por ejemplo, PUT en las transmisiones)	Cambie el método para seguir la documentación del recurso.
409	Conflicto	Un conflicto surgió de su solicitud. (por ejemplo, el OFE no esta asociado al código de autorización)	Modificar la carga útil para eliminar el conflicto..
415	Tipo de medio no admitido	La solicitud no está en un formato compatible.	Verifique que su encabezado Content-Type sea compatible y que su solicitud cumpla con la documentación.
422	Entidad no procesable	La solicitud fue sintácticamente correcta pero falló debido a errores semánticos.	Asegúrese de que su solicitud incluya todos los campos obligatorios y que sus datos sean válidos.
429	Exceder el límite de envío	Se excede el numero de transacciones permitido (120 por minuto).	Verifique que se encuentra dentro de los límites acordados con Afacturar.
500	Error de servidor interno	Algo salió mal de nuestro lado.	Pruebe la solicitud nuevamente más tarde. Si el error no se resuelve, póngase en contacto con el soporte técnico soporte@afacturar.com.
503	Servicio no disponible	Estamos experimentando niveles de tráfico más altos de lo normal.	Prueba la solicitud nuevamente, ya estamos enterado del problema para aumentar la capacidad.

Documento equivalente electronico juegos localizados ejemplos

Ejemplo 1. Juego de maquina de mesa
Ejemplo 2. Varios juegos

Ejemplo 1.


									{
	"facturas": [
		{
			"encabezado": {
				"id_factura": "9",
				"fecha": "2024-08-26",
				"hora": "00:00:00",
				"nota": [
					"{'SON':'Cincuenta mil pesos'}"
				],
				"moneda": "COP",
				"tipo_operacion": 321,
				"numero_orden": ""
			},
			"servicio": {
				"punto_de_juego": {
					"tipo": "FISICO",
					"ubicacion": "Carrera 10 96-29",
					"valor_deposito": "100000.00"
				},
				"datos_juego": [
					{
						"tipo": "Mesa",
						"cantidad_maquinas": "20"
					}
				],
				"credito_diario": [
					{
						"serial_maquina": "XYZ123",
						"valor_credito": "5000.00",
						"moneda": "COP"
					}
				]
			},
			"formas_de_pago": [
				{
					"metodo_de_pago": 1,
					"tipo_de_pago": 41,
					"identificador_de_pago": "ABDC",
					"fecha_vencimiento": ""
				}
			],
			"detalle_factura": [
				{
					"numero_linea": 1,
					"cantidad": 2,
					"unidad_de_cantidad": "94",
					"valor_unitario": "25000.00",
					"descripcion": "Mesa 1",
					"regalo": {
						"es_regalo": false,
						"cod_precio_referencia": 0,
						"precio_referencia": "0.00"
					},
					"cargo_descuento": {
						"es_descuento": false,
						"porcentaje_cargo_descuento": "0.00",
						"valor_base_cargo_descuento": "0.00",
						"valor_cargo_descuento": "0.00"
					},
					"impuestos_detalle": {
						"codigo_impuesto": 0,
						"porcentaje_impuesto": "0.00",
						"valor_base_impuesto": "0.00",
						"valor_impuesto": "0.00"
					},
					"retenciones_detalle": [
						{
							"codigo": 0,
							"porcentaje": "0.00",
							"valor_base": "0.00",
							"valor_retenido": "0.00"
						}
					],
					"valor_total_detalle_con_cargo_descuento": "50000.00",
					"valor_total_detalle": "50000.00"
				}
			],
			"impuestos": [
				{
					"codigo_impuesto": 0,
					"porcentaje_impuesto": "0.00",
					"valor_base_calculo_impuesto": "0.00",
					"valor_total_impuesto": "0.00"
				}
			],
			"retenciones": [
				{
					"codigo": 0,
					"porcentaje": "0.00",
					"valor_base": "0.00",
					"valor_retenido": "0.00"
				}
			],
			"recargos": [
				{
					"nombre_recargo": "",
					"porcentaje_recargo": "0.00",
					"valor_base_calculo_recargo": "0.00",
					"valor_total_recargo": "0.00"
				}
			],
			"descuentos": [
				{
					"codigo_descuento": 99,
					"porcentaje_descuento": "0.00",
					"descripcion_descuento": "No aplica",
					"valor_base_calculo_descuento": "0.00",
					"valor_total_descuento": "0.00"
				}
			],
			"valor_factura": {
				"valor_base": "50000.00",
				"valor_base_calculo_impuestos": "0.00",
				"valor_base_mas_impuestos": "50000.00",
				"valor_anticipo": "0.00",
				"valor_descuento_total": "0.00",
				"valor_total_recargos": "0.00",
				"valor_total_impuesto_1": "0.00",
				"valor_total_impuesto_2": "0.00",
				"valor_total_impuesto_3": "0.00",
				"valor_total_impuesto_4": "0.00",
				"valor_total_reteiva": "0.00",
				"valor_total_retefuente": "0.00",
				"valor_total_reteica": "0.00",
				"total_factura": "50000.00",
				"valor_total_a_pagar": "50000.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"version": 2,
		"identificador_transmision": "20240529",
		"integrador": {
			"nombre": "Afacturar.com",
			"tipo": "WEB"
		},
		"integrador": {
			"nombre": "Afacturar.com",
			"tipo": "WEB"
		},
		"fabricante_software": {
			"nombre_apellido": "Ricardo Albornoz",
			"razon_social": "Teleinte S.A.S",
			"nombre_software": "Afacturar.com"
		}
	}
}

Ejemplo 2.


									{
	"facturas": [
		{
			"encabezado": {
				"id_factura": "10",
				"fecha": "2024-08-26",
				"hora": "00:00:00",
				"nota": [
					"{'SON':'Cincuenta mil pesos'}"
				],
				"moneda": "COP",
				"tipo_operacion": 321,
				"numero_orden": ""
			},
			"servicio": {
				"punto_de_juego": {
					"tipo": "FISICO",
					"ubicacion": "Carrera 10 96-29",
					"valor_deposito": "100000.00"
				},
				"datos_juego": [
					{
						"tipo": "Mesa",
						"cantidad_maquinas": "2"
					},
					{
						"tipo": "Maquina tragamoneda",
						"cantidad_maquinas": "2"
					}
				],
				"credito_diario": [
					{
						"serial_maquina": "XYZ123",
						"valor_credito": "5000.00",
						"moneda": "COP"
					},
					{
						"serial_maquina": "XYZ124",
						"valor_credito": "5000.00",
						"moneda": "COP"
					},
					{
						"serial_maquina": "MATRAGA123",
						"valor_credito": "5000.00",
						"moneda": "COP"
					},
					{
						"serial_maquina": "MATRAGA124",
						"valor_credito": "5000.00",
						"moneda": "COP"
					}
				]
			},
			"formas_de_pago": [
				{
					"metodo_de_pago": 1,
					"tipo_de_pago": 41,
					"identificador_de_pago": "ABDC",
					"fecha_vencimiento": ""
				}
			],
			"detalle_factura": [
				{
					"numero_linea": 1,
					"cantidad": 2,
					"unidad_de_cantidad": "94",
					"valor_unitario": "25000.00",
					"descripcion": "Mesa 1",
					"regalo": {
						"es_regalo": false,
						"cod_precio_referencia": 0,
						"precio_referencia": "0.00"
					},
					"cargo_descuento": {
						"es_descuento": false,
						"porcentaje_cargo_descuento": "0.00",
						"valor_base_cargo_descuento": "0.00",
						"valor_cargo_descuento": "0.00"
					},
					"impuestos_detalle": {
						"codigo_impuesto": 0,
						"porcentaje_impuesto": "0.00",
						"valor_base_impuesto": "0.00",
						"valor_impuesto": "0.00"
					},
					"retenciones_detalle": [
						{
							"codigo": 0,
							"porcentaje": "0.00",
							"valor_base": "0.00",
							"valor_retenido": "0.00"
						}
					],
					"valor_total_detalle_con_cargo_descuento": "50000.00",
					"valor_total_detalle": "50000.00"
				}
			],
			"impuestos": [
				{
					"codigo_impuesto": 0,
					"porcentaje_impuesto": "0.00",
					"valor_base_calculo_impuesto": "0.00",
					"valor_total_impuesto": "0.00"
				}
			],
			"retenciones": [
				{
					"codigo": 0,
					"porcentaje": "0.00",
					"valor_base": "0.00",
					"valor_retenido": "0.00"
				}
			],
			"recargos": [
				{
					"nombre_recargo": "",
					"porcentaje_recargo": "0.00",
					"valor_base_calculo_recargo": "0.00",
					"valor_total_recargo": "0.00"
				}
			],
			"descuentos": [
				{
					"codigo_descuento": 99,
					"porcentaje_descuento": "0.00",
					"descripcion_descuento": "No aplica",
					"valor_base_calculo_descuento": "0.00",
					"valor_total_descuento": "0.00"
				}
			],
			"valor_factura": {
				"valor_base": "50000.00",
				"valor_base_calculo_impuestos": "0.00",
				"valor_base_mas_impuestos": "50000.00",
				"valor_anticipo": "0.00",
				"valor_descuento_total": "0.00",
				"valor_total_recargos": "0.00",
				"valor_total_impuesto_1": "0.00",
				"valor_total_impuesto_2": "0.00",
				"valor_total_impuesto_3": "0.00",
				"valor_total_impuesto_4": "0.00",
				"valor_total_reteiva": "0.00",
				"valor_total_retefuente": "0.00",
				"valor_total_reteica": "0.00",
				"total_factura": "50000.00",
				"valor_total_a_pagar": "50000.00"
			}
		}
	],
	"generalidades": {
		"tipo_ambiente_dian": 2,
		"version": 2,
		"identificador_transmision": "20240529",
		"integrador": {
			"nombre": "Afacturar.com",
			"tipo": "WEB"
		},
		"integrador": {
			"nombre": "Afacturar.com",
			"tipo": "WEB"
		},
		"fabricante_software": {
			"nombre_apellido": "Ricardo Albornoz",
			"razon_social": "Teleinte S.A.S",
			"nombre_software": "Afacturar.com"
		}
	}
}

Consumo del API

CURL


																curl --location 'https://servicios-pruebas.afacturar.com/api/doc_equivalente/factura_pos' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer token_obligado' \
--form 'documento_obligado="100100100"' \
--form 'data="{
	\"facturas\": [
		{
			\"encabezado\": {
				\"id_factura\": \"33\",
				\"fecha\": \"2024-05-29\",
				\"hora\": \"13:03:00\",
				\"nota\": [
					\"{'\''SON'\'':'\''XXX XXX XXX'\''\",
					\"'\''VARIABLE'\'':'\''VALOR'\''}\"
				],
				\"moneda\": \"COP\",
				\"tipo_factura\": 10,
				\"metodo_de_pago\": 1,
				\"tipo_de_pago\": 41,
				\"identificador_de_pago\": \"ABC1234\",
				\"numero_resolucion_facturacion\": \"18760000001\",
				\"fecha_vencimiento\": \"\",
				\"codigo_venta\": \"505050\",
				\"prefijo\": \"EPOS\",
				\"cantidad_puntos\": \"60\"
				
			},
			\"punto_de_venta\": {
				\"nombre\": \"Salitre plaza\",
				\"tipo\": \"FISICO\",
				\"ubicacion\": \"Calle 63\",
				\"caja\": {
					\"numero\": \"123456\",
					\"tipo\": \"maquina\"
				},
				\"datos_cajero\": {
					\"codigo\": \"123456\",
					\"identificacion\": \"337002358\",
					\"nombre\": {
						\"primer_nombre\": \"Juan\",
						\"otros_nombres\": \"Sebastian\",
						\"primer_apellido\": \"Perez\",
						\"otros_apellidos\": \"Gamboa\"
					}
				},
				\"datos_vendedor\": {
					\"codigo\": \"123456\",
					\"identificacion\": \"337002358\",
					\"nombre\": {
						\"primer_nombre\": \"Juan\",
						\"otros_nombres\": \"Sebastian\",
						\"primer_apellido\": \"Perez\",
						\"otros_apellidos\": \"Gamboa\"
					}
				}
			},
			\"informacion_comprador\": {
				\"tipo_identificacion\": 13,
				\"identificacion\": \"33700230\",
				\"correo_electronico\": \"acanon@teleinte.com\",
				\"numero_movil\": \"3142925981\",
				\"nombre\": {
					\"primer_nombre\": \"Nubia\",
					\"otros_nombres\": \"Andrea\",
					\"primer_apellido\": \"Cañón\",
					\"otros_apellidos\": \"Castellanos\"
				}
			},
			\"detalle_factura\": [
				{
					\"numero_linea\": 1,
					\"cantidad\": 1.0,
					\"unidad_de_cantidad\": \"94\",
					\"valor_unitario\": \"60000.00\",
					\"descripcion\": \"Provisión inicial afacturar\",
					\"regalo\": {
						\"es_regalo\": false,
						\"cod_precio_referencia\": 0,
						\"precio_referencia\": \"0.00\"
					},
					\"cargo_descuento\": {
						\"es_descuento\": false,
						\"porcentaje_cargo_descuento\": \"0.00\",
						\"valor_base_cargo_descuento\": \"0.00\",
						\"valor_cargo_descuento\": \"0.00\"
					},
					\"impuestos_detalle\": {
						\"codigo_impuesto\": 1,
						\"porcentaje_impuesto\": \"19.00\",
						\"valor_base_impuesto\": \"60000.00\",
						\"valor_impuesto\": \"11400.00\"
					},
					\"retenciones_detalle\": [
						{
							\"codigo\": 0,
							\"porcentaje\": \"0.00\",
							\"valor_base\": \"0.00\",
							\"valor_retenido\": \"0.00\"
						}
					],
					\"valor_total_detalle_con_cargo_descuento\": \"60000.00\",
					\"valor_total_detalle\": \"60000.00\"
				}
			],
			\"impuestos\": [
				{
					\"codigo_impuesto\": 1,
					\"porcentaje_impuesto\": \"19.00\",
					\"valor_base_calculo_impuesto\": \"60000.00\",
					\"valor_total_impuesto\": \"11400.00\"
				}
			],
			\"retenciones\": [
				{
					\"codigo\": 0,
					\"porcentaje\": \"0.00\",
					\"valor_base\": \"0.00\",
					\"valor_retenido\": \"0.00\"
				}
			],
			\"recargos\": [
				{
					\"nombre_recargo\": \"\",
					\"porcentaje_recargo\": \"0.00\",
					\"valor_base_calculo_recargo\": \"0.00\",
					\"valor_total_recargo\": \"0.00\"
				}
			],
			\"descuentos\": [
				{
					\"codigo_descuento\": 99,
					\"porcentaje_descuento\": \"0.00\",
					\"descripcion_descuento\": \"No aplica\",
					\"valor_base_calculo_descuento\": \"0.00\",
					\"valor_total_descuento\": \"0.00\"
				}
			],
			\"valor_factura\": {
				\"valor_base\": \"60000.00\",
				\"valor_base_calculo_impuestos\": \"60000.00\",
				\"valor_base_mas_impuestos\": \"71400.00\",
				\"valor_descuento_total\": \"0.00\",
				\"valor_total_recargos\": \"0.00\",
				\"valor_total_impuesto_1\": \"11400.00\",
				\"valor_total_impuesto_2\": \"0.00\",
				\"valor_total_impuesto_3\": \"0.00\",
				\"valor_total_impuesto_4\": \"0.00\",
				\"valor_total_reteiva\": \"0.00\",
				\"valor_total_retefuente\": \"0.00\",
				\"valor_total_reteica\": \"0.00\",
				\"total_factura\": \"71400.00\",
				\"valor_total_a_pagar\": \"71400.00\"
			}
		}
	],
	\"generalidades\": {
		\"tipo_ambiente_dian\": 2,
		\"version\": 2,
		\"identificador_transmision\": \"2019 validación previa\",
		\"integrador\": {
			\"nombre\": \"Afacturar.com\",
			\"tipo\": \"WEB\"
		}
	}
}"'

C#


																var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://servicios-pruebas.afacturar.com/api/doc_equivalente/factura_pos");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer token_obligado");
var content = new MultipartFormDataContent();
content.Add(new StringContent("100100100"), "documento_obligado");
content.Add(new StringContent("{
	\"facturas\": [
		{
			\"encabezado\": {
				\"id_factura\": \"33\",
				\"fecha\": \"2024-05-29\",
				\"hora\": \"13:03:00\",
				\"nota\": [
					\"{'SON':'XXX XXX XXX'\",
					\"'VARIABLE':'VALOR'}\"
				],
				\"moneda\": \"COP\",
				\"tipo_factura\": 10,
				\"metodo_de_pago\": 1,
				\"tipo_de_pago\": 41,
				\"identificador_de_pago\": \"ABC1234\",
				\"numero_resolucion_facturacion\": \"18760000001\",
				\"fecha_vencimiento\": \"\",
				\"codigo_venta\": \"505050\",
				\"prefijo\": \"EPOS\",
				\"cantidad_puntos\": \"60\"
				
			},
			\"punto_de_venta\": {
				\"nombre\": \"Salitre plaza\",
				\"tipo\": \"FISICO\",
				\"ubicacion\": \"Calle 63\",
				\"caja\": {
					\"numero\": \"123456\",
					\"tipo\": \"maquina\"
				},
				\"datos_cajero\": {
					\"codigo\": \"123456\",
					\"identificacion\": \"337002358\",
					\"nombre\": {
						\"primer_nombre\": \"Juan\",
						\"otros_nombres\": \"Sebastian\",
						\"primer_apellido\": \"Perez\",
						\"otros_apellidos\": \"Gamboa\"
					}
				},
				\"datos_vendedor\": {
					\"codigo\": \"123456\",
					\"identificacion\": \"337002358\",
					\"nombre\": {
						\"primer_nombre\": \"Juan\",
						\"otros_nombres\": \"Sebastian\",
						\"primer_apellido\": \"Perez\",
						\"otros_apellidos\": \"Gamboa\"
					}
				}
			},
			\"informacion_comprador\": {
				\"tipo_identificacion\": 13,
				\"identificacion\": \"33700230\",
				\"correo_electronico\": \"acanon@teleinte.com\",
				\"numero_movil\": \"3142925981\",
				\"nombre\": {
					\"primer_nombre\": \"Nubia\",
					\"otros_nombres\": \"Andrea\",
					\"primer_apellido\": \"Cañón\",
					\"otros_apellidos\": \"Castellanos\"
				}
			},
			\"detalle_factura\": [
				{
					\"numero_linea\": 1,
					\"cantidad\": 1.0,
					\"unidad_de_cantidad\": \"94\",
					\"valor_unitario\": \"60000.00\",
					\"descripcion\": \"Provisión inicial afacturar\",
					\"regalo\": {
						\"es_regalo\": false,
						\"cod_precio_referencia\": 0,
						\"precio_referencia\": \"0.00\"
					},
					\"cargo_descuento\": {
						\"es_descuento\": false,
						\"porcentaje_cargo_descuento\": \"0.00\",
						\"valor_base_cargo_descuento\": \"0.00\",
						\"valor_cargo_descuento\": \"0.00\"
					},
					\"impuestos_detalle\": {
						\"codigo_impuesto\": 1,
						\"porcentaje_impuesto\": \"19.00\",
						\"valor_base_impuesto\": \"60000.00\",
						\"valor_impuesto\": \"11400.00\"
					},
					\"retenciones_detalle\": [
						{
							\"codigo\": 0,
							\"porcentaje\": \"0.00\",
							\"valor_base\": \"0.00\",
							\"valor_retenido\": \"0.00\"
						}
					],
					\"valor_total_detalle_con_cargo_descuento\": \"60000.00\",
					\"valor_total_detalle\": \"60000.00\"
				}
			],
			\"impuestos\": [
				{
					\"codigo_impuesto\": 1,
					\"porcentaje_impuesto\": \"19.00\",
					\"valor_base_calculo_impuesto\": \"60000.00\",
					\"valor_total_impuesto\": \"11400.00\"
				}
			],
			\"retenciones\": [
				{
					\"codigo\": 0,
					\"porcentaje\": \"0.00\",
					\"valor_base\": \"0.00\",
					\"valor_retenido\": \"0.00\"
				}
			],
			\"recargos\": [
				{
					\"nombre_recargo\": \"\",
					\"porcentaje_recargo\": \"0.00\",
					\"valor_base_calculo_recargo\": \"0.00\",
					\"valor_total_recargo\": \"0.00\"
				}
			],
			\"descuentos\": [
				{
					\"codigo_descuento\": 99,
					\"porcentaje_descuento\": \"0.00\",
					\"descripcion_descuento\": \"No aplica\",
					\"valor_base_calculo_descuento\": \"0.00\",
					\"valor_total_descuento\": \"0.00\"
				}
			],
			\"valor_factura\": {
				\"valor_base\": \"60000.00\",
				\"valor_base_calculo_impuestos\": \"60000.00\",
				\"valor_base_mas_impuestos\": \"71400.00\",
				\"valor_descuento_total\": \"0.00\",
				\"valor_total_recargos\": \"0.00\",
				\"valor_total_impuesto_1\": \"11400.00\",
				\"valor_total_impuesto_2\": \"0.00\",
				\"valor_total_impuesto_3\": \"0.00\",
				\"valor_total_impuesto_4\": \"0.00\",
				\"valor_total_reteiva\": \"0.00\",
				\"valor_total_retefuente\": \"0.00\",
				\"valor_total_reteica\": \"0.00\",
				\"total_factura\": \"71400.00\",
				\"valor_total_a_pagar\": \"71400.00\"
			}
		}
	],
	\"generalidades\": {
		\"tipo_ambiente_dian\": 2,
		\"version\": 2,
		\"identificador_transmision\": \"2019 validación previa\",
		\"integrador\": {
			\"nombre\": \"Afacturar.com\",
			\"tipo\": \"WEB\"
		}
	}
}"), "data");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Historico de cambios

Versión	Cambios	Fecha de liberación
2	Creación del API	19 de Julio de 2024

Factura nacional

Factura de mandato

Factura de exportación

Factura de contingencia

Nota credito

Nota debito

Documento soporte en adquisición

Notas de ajuste Doc soporte en adquisición

DEE-POS

DEE-Servicio Publicos Domiciliarios

DEE-Juegos localizados

Nómina-Enviar

Nómina-Reemplazar

Nómina-Eliminar

DEE- Factura

Nota credito

DEE - Factura

Nota credito

Historico de eventos

Lector CUFE

Acuse de recibo FEV

Recibo del B/S

Aceptación expresa

Aceptación tácita

Reclamo FEV

Token de acceso

Transacciones emitidas

Consultar legítimo tenedor

Integración

DEE-JL ( DOCUMENTO EQUIVALENTE ELECTRÓNICO JUEGOS LOCALIZADOS)

EndPoint

Parámetros de entrada

HEADERS

BODY

Estructura de JSON de entrada

DEE - Juegos localizados

Estructura json

Estructura JSON de respuesta

Salida Exitosa

Salida con errores de semantica

Salida con errores de datos

Salida con errores HTTP

Salida con error de datos en la DIAN

Codigo de respuesta

Códigos de ERROR

Documento equivalente electronico juegos localizados ejemplos

Ejemplo 1.

Ejemplo 2.

Consumo del API

CURL

C#

Historico de cambios