Saltar al contenido

POS y 9 tipos más · 94 · 93

Documento equivalente electrónico. El tiquete POS y nueve tipos más, con su nota de ajuste.

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.

Cuando la venta no lleva factura, lleva su documento equivalente. Validado por la DIAN, con su CUDE.

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).

  • Varias cajas.

    Cada caja lleva su placa, su ubicación y su cajero, y puede numerar con el prefijo de su propia resolución.

  • Consumidor final.

    El tiquete POS sale a consumidor final, sin pedirle datos al comprador.

  • Con PDF y correo.

    Después de que la DIAN lo valida, Trevol arma el PDF y el ZIP y lo entrega por correo, como la factura.

Diez tipos en una sola ruta. Cada uno con su información propia.

Tiquete POS (20)

  • La caja: placa, ubicación, cajero y tipo
  • El prefijo de su resolución
  • Consumidor final

Nueve tipos más

  • 25 · Cine · 27 · Espectáculos · 30 · Juegos de suerte y azar
  • 35 · Transporte de pasajeros · 40 · Peajes · 45 · Extractos
  • 50 · Transporte aéreo · 55 · Bolsa de valores y agropecuaria · 60 · Servicios públicos

Notas de ajuste

  • Nota crédito (94)
  • Nota débito (93)

Contingencia

  • La 07: un documento físico que se transcribe

¿Prefieres factura? La factura electrónica

Un tipo para cada sector. La misma ruta de la API, con la información propia de cada uno.

Tipos de documento equivalente y su código
CódigoDocumento
20Tiquete POS
25Cine
27Espectáculos públicos
30Juegos de suerte y azar
35Transporte terrestre de pasajeros
40Cobro de peajes
45Extracto
50Transporte aéreo de pasajeros
55Bolsa de valores y agropecuaria
60Servicios 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.

Expídelo desde tu caja o tu software. POST /v1/equivalent_documents.

  • El POS lleva su caja en pos.register y, si tienes varias cajas, el prefijo de su resolución en numbering.prefix.
  • El PDF y el correo salen después del 201: espera equivalent_document.delivered o consulta delivery.status.
  • La misma Idempotency-Key durante 7 días devuelve el mismo documento.
Ejemplo
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

De la tienda con varias cajas. A la devolución en el mostrador.

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
Devolución en caja

La nota de ajuste crédito (94) con el concepto 1 devuelve lo que el cliente trajo de vuelta.

Nota
94
Concepto
1
Un documento físico

Si en una contingencia se expidió un documento en papel, se transcribe como documento equivalente con la contingencia 07.

Contingencia
07

Comparte el conteo con tus facturas. Sin mensualidad.

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

Conector ContaPyme

Ver precios del conector

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.

Preguntas sobre el documento equivalente. Y sobre su habilitación.

¿Qué tipos de documento equivalente emite Trevol?

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).

¿El POS necesita su propia resolución?

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.

¿Cada documento tiene su habilitación?

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.

¿Qué pasa si la DIAN rechaza un documento?

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.

Todas las preguntas

Si la venta pide factura. O expide el documento equivalente desde la app o la API.

Emítelo desde: App web · API

Expide tu primer tiquete POS electrónico.

Sin plan, sin mensualidad y con precios publicados. Empiezas con $ 2.000 de saldo y las pruebas de habilitación no se cobran.

Cómo empezar

Cuenta, empresa y habilitación ante la DIAN, en tres pasos.

Ver los pasos

Documentación

La guía y la referencia de la API v1.

Leer la documentación