Una tienda con varias cajas
Cada caja numera con el prefijo de su resolución POS; el tiquete dice qué caja y qué cajero lo expidió.
- Caja
pos.register- Prefijo
numbering.prefix
POS y 9 tipos más · 94 · 93
Para la venta de mostrador, el tiquete POS electrónico; para los sectores que la DIAN trata aparte, su propio documento equivalente. Trevol los expide como la factura: valida, firma y envía, y cuando la DIAN valida, entrega el PDF y el XML.
Al crear tu cuenta recibes $ 2.000 de saldo de bienvenida.
Ejemplo con datos ficticios: un tiquete POS de $ 14.500 como documento equivalente electrónico, con su CUDE y su código QR.
El documento equivalente electrónico reemplaza a la factura en las ventas que la DIAN trata aparte: el tiquete de una caja registradora (POS), una boleta de cine, un peaje, un servicio público. La DIAN lo valida como a la factura, con su código único, el CUDE, y se corrige con su nota de ajuste, crédito (94) o débito (93).
Cada caja lleva su placa, su ubicación y su cajero, y puede numerar con el prefijo de su propia resolución.
El tiquete POS sale a consumidor final, sin pedirle datos al comprador.
Después de que la DIAN lo valida, Trevol arma el PDF y el ZIP y lo entrega por correo, como la factura.
| Código | Documento |
|---|---|
| 20 | Tiquete POS |
| 25 | Cine |
| 27 | Espectáculos públicos |
| 30 | Juegos de suerte y azar |
| 35 | Transporte terrestre de pasajeros |
| 40 | Cobro de peajes |
| 45 | Extracto |
| 50 | Transporte aéreo de pasajeros |
| 55 | Bolsa de valores y agropecuaria |
| 60 | Servicios públicos domiciliarios |
¿Prefieres factura? Los seis pasos son los de la factura electrónica
Todos van por la misma ruta de la API y por Equivalentes en la app: cambia el document_type. Cada tipo tiene su propia habilitación ante la DIAN; mientras la DIAN valida el set de pruebas, la API responde 202 validating.
POST /v1/equivalent_documents.pos.register y, si tienes varias cajas, el prefijo de su resolución en numbering.prefix.equivalent_document.delivered o consulta delivery.status.Idempotency-Key durante 7 días devuelve el mismo documento.curl https://api.trevol.si/v1/equivalent_documents \
-H "Authorization: Bearer $TREVOL_LLAVE" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"external_id": "TIQ-1",
"customer": {"final_consumer": true},
"pos": {
"register": {
"plate": "CJ-01",
"location": "Local 1, Jamundí",
"cashier": "PEREZ ANA",
"type": "Caja principal"
}
},
"numbering": {"prefix": "POS2"},
"payment": {"form": "cash", "methods": [{"code": "10"}]},
"items": [
{
"description": "Gaseosa 400 ml",
"code": "GAS-1",
"unit": "94",
"quantity": "2",
"unit_price": "3000",
"taxes": [{"code": "01", "rate": "19"}]
},
{
"description": "Almuerzo",
"unit": "94",
"quantity": "1",
"unit_price": "18000"
}
]
}'curl https://api.trevol.si/v1/equivalent_document_adjustments \
-H "Authorization: Bearer $TREVOL_LLAVE" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"external_id": "TIQ-1-DEV",
"note_type": "credit",
"concept": "1",
"equivalent_document": {"id": "pos_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b"},
"items": [{
"description": "Devolución gaseosa",
"unit": "94",
"quantity": "1",
"unit_price": "3000",
"taxes": [{"code": "01", "rate": "19"}]
}]
}'El prefijo POS2 del ejemplo es ilustrativo: usa el de tu resolución.
POST /v1/equivalent_documentsDocumento equivalente en la guía
Cada caja numera con el prefijo de su resolución POS; el tiquete dice qué caja y qué cajero lo expidió.
pos.registernumbering.prefixLa nota de ajuste crédito (94) con el concepto 1 devuelve lo que el cliente trajo de vuelta.
Si en una contingencia se expidió un documento en papel, se transcribe como documento equivalente con la contingencia 07.
Cada documento se cobra cuando la DIAN lo valida, sin mensualidad. Facturas, notas, POS, documentos equivalentes y documentos soporte comparten el conteo del mes de tu cuenta.
$ 500 → $ 15
por documento validado, según el consumo de tu cuenta
Del 1 al 10: $ 500 c/u
Llega pronto al conector. Se cobrará igual que una factura, en el mismo conteo de la empresa.
El POS electrónico llega pronto al conector.
Llega pronto
Las pruebas de habilitación no se cobran. Si la DIAN rechaza un documento, no pagas: lo apartado vuelve a tu saldo.
El tiquete POS (20) y nueve tipos más: cine (25), espectáculos (27), juegos de suerte y azar (30), transporte de pasajeros (35), peajes (40), extractos (45), transporte aéreo (50), bolsa de valores y agropecuaria (55) y servicios públicos (60), con su nota de ajuste crédito (94) o débito (93).
Sí: el tiquete POS numera con su resolución de la DIAN. Si tienes varias cajas con prefijos distintos, cada una numera con el suyo.
La factura y sus notas se habilitan al vincular la empresa. El documento soporte, cada tipo de documento equivalente y la nómina tienen su propia habilitación ante la DIAN.
Al enviarlo se aparta su precio de tu saldo. Si la DIAN lo rechaza, lo apartado vuelve a tu saldo y el documento conserva su número: se corrige y se reenvía. Se cobra una sola vez, cuando la DIAN lo valida.
01 · 02
Nacional y de exportación, con el Anexo Técnico 1.9.
91 · 92
Corrigen una factura validada, de Trevol o de otro software.
05 · 95
Para lo que compras a quienes no están obligados a facturar.
Sin plan, sin mensualidad y con precios publicados. Empiezas con $ 2.000 de saldo y las pruebas de habilitación no se cobran.