Tiquete Electrónico

El Tiquete Electrónico (document_type: "04") es el comprobante de venta al consumidor final. Usalo en el mostrador, en el punto de venta o en una tienda en línea cuando el cliente no necesita el comprobante a su nombre.

Si el cliente pide factura (por ejemplo, para deducir el gasto o acreditar el IVA), emití una Factura Electrónica en su lugar: el tiquete no le sirve para eso.

Qué lo distingue

Campo	Regla en el TE
receiver	Opcional. Si lo enviás, name es obligatorio
receiver.address	Opcional
document.activity_code	Obligatorio
issuer.address y issuer.email	Obligatorios
items[].tax	Al menos un impuesto por línea, igual que en la factura
items[].tariff_code	No se permite
Total	Aster acepta tiquetes en colones de hasta ₡2 500 000. Para montos mayores, emití una factura

Una terminal por caja

El consecutivo incluye la sucursal (3 dígitos) y la terminal (5 dígitos). Asigná una terminal distinta a cada caja o punto de venta: así cada caja tiene su propia secuencia, dos cajas nunca compiten por el mismo número y el consecutivo te dice de qué caja salió cada tiquete.

Caja	branch	terminal	Primer consecutivo de tiquete
Caja 1, local central	001	00001	00100001040000000001
Caja 3, local central	001	00003	00100003040000000001
Caja 1, sucursal Escazú	002	00001	00200001040000000001

Aster lleva un contador por sucursal, terminal y tipo de documento. Ver sucursal y terminal.

Ejemplo completo

Una venta en la caja 3, pagada por SINPE Móvil, sin receptor:

tiquete.json

{
  "document": {
    "document_type": "04",
    "activity_code": "475201",
    "date": "2026-10-08T11:42:00-06:00",
    "situation": "1",
    "branch": "001",
    "terminal": "00003"
  },
  "commercial_info": {
    "currency": "CRC",
    "sale_condition": "01",
    "payment_method": "06"
  },
  "issuer": {
    "type": "02",
    "id": "3101654321",
    "name": "Ferretería La Sabana S.A.",
    "commercial_name": "Ferretería La Sabana",
    "email": "facturas@ferreterialasabana.cr",
    "phone": "22905511",
    "address": {
      "province": "1",
      "canton": "08",
      "district": "01",
      "details": "Del Más x Menos 200 m sur"
    }
  },
  "items": [
    {
      "line_number": 1,
      "cabys_code": "4292199990200",
      "quantity": 1,
      "unit": "Unid",
      "description": "Martillo de uña 16 oz",
      "price": 6500,
      "tax": [
        { "type": "01", "rate_code": "08", "rate": 13 }
      ]
    },
    {
      "line_number": 2,
      "cabys_code": "4292104010100",
      "quantity": 2,
      "unit": "Unid",
      "description": "Llave ajustable 10 pulgadas",
      "price": 8900,
      "tax": [
        { "type": "01", "rate_code": "08", "rate": 13 }
      ]
    }
  ]
}

Línea	Subtotal	IVA 13 %	Total línea
1. Martillo	6 500	845	7 345
2. Llaves (2 × 8 900)	17 800	2 314	20 114
Tiquete	24 300	3 159	27 459

Terminal

curl https://aster.astranexo.com/api/v1/electronic-documents \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: caja3-venta-88120" \
  --data @tiquete.json

Respuesta

201 Created

{
  "success": true,
  "message": "Document submitted for processing.",
  "data": {
    "id": 412,
    "document_key": "50608102600310165432100100003040000005318163027415",
    "consecutive_number": "00100003040000005318",
    "document_type": "04",
    "document_type_name": "Tiquete Electrónico",
    "status": "processing",
    "environment": "staging",
    "queued_at": "2026-10-08T17:42:01Z"
  }
}

Recomendaciones para punto de venta

• No esperes el veredicto para entregar la venta. El 201 llega en milisegundos; Hacienda responde después. Imprimí el tiquete con la clave y el consecutivo de la respuesta y procesá el veredicto por webhook.
• Usá una llave de idempotencia por venta, por ejemplo el número de transacción de la caja. Si la red falla y el POS reintenta, Aster devuelve el mismo tiquete en vez de emitir otro. Ver idempotencia.
• Si el cliente da su correo, agregá receiver con name y email y pedí el envío con "delivery": { "email": true }. Ver PDF y correo.
• Medios de pago comunes: 01 efectivo, 02 tarjeta, 06 SINPE Móvil.

Errores que Aster detecta antes de firmar

Situación	Código de Hacienda	Qué hacer
CABYS inexistente	-400	Buscalo en GET /reference/cabys?q=...
Unidad de servicio con CABYS de mercancía, o al revés	-110 / -111	Revisá unit y cabys_code
Tarifa y código de tarifa no coinciden	-505	08 es 13 %, 04 es 4 %, 02 es 1 %, 01 es 0 %
Receptor sin nombre	—	Si enviás receiver, incluí name
Total en colones mayor a ₡2 500 000	—	Emití una Factura Electrónica

Ver errores.