JSON POS ELECTRÓNICO
Método de envío.
Para el proceso de pruebas de la factura de exportación recuerde
- Solicitar el TOKEN
- Valide el parámetro de envió para pruebas
“sMethod”: “classTaxxa.fjDocumentAdd”,
“jParams”: {
“wVersionUBL”: 2.1,
“wEnvironment”: “test”,
El ambiente de producción debe ajustar el parámetro de la siguiente forma:
“sMethod”: “classTaxxa.fjDocumentAdd”,
“jParams”: {
“wVersionUBL”: 2.1,
“wEnvironment”: “prod”,
Prefijos para pruebas de Documento pos electrónico
PREFIJO: EPOS
Número inicial: 1
Número Final: 1000
A continuación, realizamos entrega Json Pos Electrónico
{
"sToken": "0000000000000",
"jApi": {
"sMethod": "classTaxxa.fjDocumentAdd",
"jParams": {
"wEnvironment": "test",
"wVersionUBL": 2.1,
"jDocument": {
"wdocumenttype": "Pos",
"wdocumenttypecode": "20",
"sdocumentprefix": "EPOS",
"sdocumentsuffix": "451",
"tissuedate": "2024-03-26 13:59:21",
"tduedate": "2024-03-01",
"wpaymentmeans": 1,
"wpaymentmethod": "10",
"wbusinessregimen": 2,
"woperationtype": "10",
"nlineextensionamount": 7000,
"ntaxexclusiveamount": 7000,
"ntaxinclusiveamount": 8890,
"npayableamount": 8890,
"rdocumenttemplate": "26190537",
"wcurrency": "COP",
"snotes": "PLACA : FST765 / KILOMETRAJE: 49712",
"snotetop": "IVA Régimen Común No somos Agentes de Retención de IVA No somos Grandes Contribuyentes Actividad Económica ICA 4520 9.66 X 1000",
"sorderreference": "23548",
"tdatereference": "2024-01-17",
"jextrainfo": {
"ssalespersonname": "JHON ALEXIS",
"iitemscount": 9,
"ilinescount": 9,
"slocationname": "",
"stotalinvoicewords": "",
"ndelivery": 0
},
"jseller": {
"wlegalorganizationtype": "person",
"sfiscalresponsibilities": "R-99-PN",
"sdocid": "901402281",
"sdoctype": "NIT",
"ssellername": "RAZON SOCIAL DEL VENDEDOR COMO SE ENCUENTRA EN EL RUT",
"ssellerbrand": "NOMBRE COMERCIAL DEL ESTABLECIMIENTO",
"scontactperson": "NOMBRE PERSONA DE CONTACTO",
"saddresszip": "110001",
"wdepartmentcode": "11",
"wtowncode ": "11001",
"scityname": "BOGOTA",
"jcontact": {
"selectronicmail": "correo@correo.com",
"jregistrationaddress": {
"wdepartmentcode": "85",
"scityname": "RIOHACHA - LA GUAJIRA",
"saddressline1": "CL 13 11 75",
"scountrycode": "CO",
"wprovincecode": "44001",
"szip": "440001",
"sdepartmentname": "GUAJIRA"
}
}
},
"jbuyerpoints": {
"0": {
"sname": "Codigo",
"svalue": "000000000"
},
"1": {
"sname": "NombresApellidos",
"svalue": "XXXXXXXXXXX"
},
"2": {
"sname": "Puntos",
"svalue": "100"
}
},
"jcajapos": {
"0": {
"sname": "PlacaCaja",
"svalue": "234566"
},
"1": {
"sname": "UbicaciónCaja",
"svalue": "XXXXXXXXXXXXX"
},
"2": {
"sname": "Cajero",
"svalue": "Pablito"
},
"3": {
"sname": "TipoCaja",
"svalue": "Caja de apoyo"
},
"4": {
"sname": "CódigoVenta",
"svalue": "743992"
},
"5": {
"sname": "SubTotal",
"svalue": "1000100"
}
},
"jdocumentitems": {
"0": {
"jextrainfo": {
"sbarcode": "021566",
"npacksizenumeric": "12",
"sbrandname": "mister",
"smodelname": "chocolate"
},
"sdescription": "Brownies",
"snotes": "",
"wunitcode": "U",
"sgroupname": "alimentos",
"sstandarditemidentification": "00235",
"sstandardidentificationcode": "999",
"nunitprice": 7000,
"nusertotal": 7000,
"nquantity": "1.00",
"jtax": {
"jiva": {
"nrate": 19,
"sname": "IVA",
"namount": 1330,
"nbaseamount": 7000
},
"jinc": {
"nrate": 8,
"sname": "INC",
"namount": 560,
"nbaseamount": 7000
}
}
}
},
"jbuyer": {
"wlegalorganizationtype": "person",
"scostumername": "CONSUMIDOR FINAL",
"stributaryidentificationkey": "ZZ",
"stributaryidentificationname": "No aplica",
"sfiscalresponsibilities": "R-99-PN",
"sfiscalregime": "48",
"jpartylegalentity": {
"wdoctype": "CC",
"sdocno": "222222222222",
"scorporateregistrationschemename": "CONSUMIDOR FINAL"
},
"jcontact": {
"scontactperson": "CONSUMIDOR FINAL",
"selectronicmail": "xxxxxxxxxxxxxxxxxxxxxx",
"stelephone": "0000000"
}
}
}
}
}
}
A continuación Encontrará Explicación de los campos adicionales para emitir Pos Electrónico. Dentor de este entregamos los diccionarios para campos como tipo de operación o tipos documento.
Campo | Descripción |
«wdocumenttype»: «Pos», | Tipo de Documento enviar Pos |
«wdocumenttypecode»: «20», | Enviar el código del tipo de documento 20 —> Documento equivalente electrónico del tiquete de máquina registradora con sistema P.O.S. 25 —> Boleta de ingreso a cine 27 —> Boleta de ingreso a espectáculos públicos 30 —> Documento en juegos localizados y no localizados – relación diaria de control de ventas 35 —> Tiquete de transporte de pasajeros Terrestre 40 —> Documento expedido para el cobro de peajes 45 —> Extracto Expedido por Sociedades Financieras y Fondos 50 —> Tiquete de Billete de Transporte Aéreo de Pasajeros 55 —> Documento de Operación de Bolsa de Valores, Agropecuaria y de Otros Comodities 60 —> Documento Expedido para los Servicios Públicos y Domiciliarios |
«sdocumentprefix»: «EPOS«, | Prefijo para ciclo de pruebas use EPOS |
«sdocumentsuffix»: «1», | Sufijo para pruebas número inicial 1 número final 1000 |
«snotetop»: «IVA Régimen Común No somos Agentes de Retención de IVA», | Encabezado factura importante para la tirilla Pos indicar agente retenedor. |
«rdocumenttemplate»: «26190537», | Enviar Valor por defecto 26190537 |
«scustomizationid«: «10«, |
Doc Equivalente | Código | Nombre |
20 | 10 | Código único para los documentos equivalentes que no cuentan más de un modo de operación. |
25 | ||
35 | ||
40 | ||
45 | ||
50 | ||
60 | 601 | facturación Normal |
602 | facturación en Sitio | |
32 | 321 | Reporte Diario |
322 | Reporte Diario Final | |
27 | 271 | Estándar espectáculos públicos de las artes Escénicas. * |
272 | Mandato espectáculos públicos de las artes Escénicas. ** | |
273 | Estándar de otros espectáculos públicos. *** | |
274 | Mandato de otros espectáculos públicos. **** | |
55 | 551 | El comprobante de Liquidación de operaciones expedido por bolsa de valores |
552 | El documento de operaciones de bolsa agropecuaria y de otros como Commodities. | |
07 – 08 Contingencias ***** | 20 | Documento equivalente electrónico del tiquete de máquina registradora con sistema P.O.S. (Código utilizado cuando cbc:InvoiceTypeCode =07 o 08) |
25 | Boleta de ingreso a cine (Código utilizado cuando cbc:InvoiceTypeCode =07 o 08) | |
27 | Boleta de ingreso a espectáculos públicos (Código utilizado cuando cbc:InvoiceTypeCode =07 o 08) | |
32 | Documento en juegos localizados – relación diaria de control de ventas (Código utilizado cuando cbc:InvoiceTypeCode =07 o 08) | |
35 | Tiquete de transporte de pasajeros Terrestre (Código utilizado cuando cbc:InvoiceTypeCode =07 o 08) |
Campo | Descripción / catalogo |
«0»: { | Enumere la cadena, no debe repetir la numeración |
«sname»: «Código», | Nombre del campo ver ejemplo del JSON para ver los campos y ejemplos |
«sValue»: «79907759» | Valor del campo |
Codigo | Descripción / Catalogo |
«0»: { | Enumere la cadena, no repita el numero |
«sname»: «PlacaCaja», | Nombre del campo ver ejemplo del JSON para ver los campos y ejemplos |
«sValue»: «234566» | Valor del campo |
Campo | Descripción / Catalogo |
«nPackSizeNumeric»: «», | Numero de unidades del paquete |
«sBrandName»: «», | Marca del item |
«ModelName»: «» | Modelo del item |
Campo | Descripción / Catalogo |
«ssalespersonname»: «JHON ALEXIS», | Nombre del Vendedor |
«iitemscount»: 9, | Cantidad de ítems de la factura, sume las cantidades |
«ilinescount»:9, | Cantidad de líneas de la factura |
«slocationname»:»», | Punto de venta |
«stotalinvoicewords»:»», | Importe en letras del documento |
«ndelivery»: 0 | Domicilio, valor informativo, no viaja a la Dian solo se visualiza en el PDF si lo desea sumar dentro del total de la factura envié el valor como un recargo |
IMPORTANTE: Si el cliente no suministra los datos recuerde que debe generar el documento a nombre CONSUMIDOR FINAL:
1. TIPO DE DOCUMENTO CC
2. NOMBRE: CONSUMIDOR FINAL
3. RESPONSABILIDAD FISCAL R-99-PN
4. IDENTIFICACIÓN TRIBUTARIA ZZ = No aplica*
5. El correo electrónico es opcional
6. NUMERO DE DOCUMETNO DE IDENTIDAD: 222222222222
Notas Aclaratorias POS Electrónico:
- Si deseas reaizar pruebas para pos electrónico confirma por medio de soporte para habilitar a tu cliente.
- No olvides que el Set de pruebas es diferente al de factura.
- Recuerda validar siempre el tipo y código de operación.
- TAXXA SAS taxxa
- Versión : Anexo técnico 1.9 DIAN