Qué es el CAByS y cómo encontrar el código de tu producto o servicio

Respuesta corta: el CAByS (Catálogo de Bienes y Servicios) es la lista oficial de códigos de 13 dígitos con que se clasifica cada línea de un comprobante electrónico. El código dice si la línea es un bien (primer dígito de 0 a 4) o un servicio (de 5 a 9) y trae asociada la tarifa de IVA del producto. Se busca por descripción en la consulta pública de Hacienda o en tu sistema de facturación; un código que no existe hace que Hacienda rechace el comprobante con -400.

Es el dato que más confunde al empezar y la causa de rechazo más común en una integración nueva. Esta guía explica qué es, cómo buscarlo y cómo elegir bien.

Para qué sirve el CAByS

En cada línea de la factura, el CAByS hace dos cosas:

1. Clasifica la línea. El primer dígito determina si es mercancía o servicio, y de eso depende en qué total del comprobante suma. Hacienda vuelve a calcular la clasificación desde el CAByS: si tu sistema dice otra cosa, gana el código.
2. Indica la tarifa de IVA que le corresponde: 13 %, una tarifa reducida o exento.

Un detalle que confunde: los códigos que empiezan con 5 son «construcciones y servicios de construcción» y cuentan como servicio, aunque incluyan la obra.

Cómo encontrar tu código

1. En la consulta pública de Hacienda

Hacienda publica una consulta sin autenticación en api.hacienda.go.cr: se busca por descripción (/fe/cabys?q=…) o por código exacto (/fe/cabys?codigo=…), y cada resultado trae su descripción y su impuesto.

2. En el archivo del BCCR

El catálogo completo se publica como hoja de cálculo en el sitio del Banco Central. Sirve para revisar tu lista de productos de una vez.

3. En tu sistema de facturación

Lo práctico es buscarlo donde facturás. En Facturaencr, el buscador de productos encuentra el código por descripción y le pone la tarifa sola. Por API:

curl "https://api.facturaencr.com/v2/efactura/catalogs/cabys?q=pan%20pita&top=5" \
  -H "X-API-Key: $EFACTURA_KEY" -H "X-API-Secret: $EFACTURA_SECRET"

{
  "items": [
    { "codigo": "2999999999007", "descripcion": "Pan pita o pan árabe, sin congelar", "impuesto": 1 }
  ]
}

(El código del ejemplo es ficticio: buscá siempre el real.)

Cómo elegir bien entre varios parecidos

• Buscá con palabras simples: «pan», «consultoría», «reparación de computadoras». La descripción del catálogo es técnica.
• Fijate en el primer dígito: si vendés un servicio, el código tiene que empezar entre 5 y 9.
• Mirá la tarifa asociada: si tu producto lleva 13 % y el código dice 1 %, probablemente no es el tuyo. Lo que define la tarifa es el código; no la elijas aparte.
• Ante la duda, consultá con tu contador. La clasificación tiene efectos en el IVA que cobrás.

Errores que hacen rechazar el comprobante

Error	Qué pasa
Código que no existe	Hacienda rechaza con -400 y el consecutivo se consume
Copiar un código de un ejemplo o de otro negocio	Puede no existir o no ser tu producto
Bien o servicio contradictorio con el código	Hacienda re-deriva la clasificación del CAByS
En una nota de crédito, un CAByS distinto al de la factura	Rechazo -509

La validación más útil se hace una sola vez: pasá tu lista de productos por el buscador y marcá los códigos que no devuelvan resultado. Los rechazos más comunes están en rechazos de Hacienda: códigos y soluciones.

CAByS en notas de crédito y exportaciones

• Notas de crédito y débito: tienen que usar los mismos CAByS de la factura que corrigen. Si una línea trae un código que no estaba en el original, Hacienda rechaza con -509. Para cobrar algo nuevo, va una factura aparte.
• Facturas de exportación de mercancía: además del CAByS, la línea lleva la partida arancelaria. Una nota sobre una exportación tiene que repetir la línea tal cual, con el mismo CAByS y la misma partida; si no, el rechazo es -503 o -509.

Guardalo una vez, no en cada factura

El error más caro es buscar el código en cada venta. Lo práctico es guardarlo en tu catálogo de productos una sola vez, revisado, y que cada factura lo tome de ahí. Así un código mal elegido se corrige en un lugar y no aparece en cientos de comprobantes. Si migrás productos desde otro sistema, aprovechá para verificar todos los códigos contra el buscador antes de emitir.

La tarifa que trae el CAByS

Cada código trae su impuesto asociado. Algunos dicen un porcentaje y otros dicen exento. Esa tarifa es la que va en el código de tarifa de la línea: 08 para el 13 %, 02 para el 1 %, 10 para exento, entre otros. La tabla completa: códigos de tarifa del IVA vigentes.

Si tu cliente tiene una exoneración, el CAByS no cambia: la exoneración se declara aparte en la línea.

Preguntas frecuentes

¿Qué significa CAByS?

Catálogo de Bienes y Servicios. Es la clasificación oficial que se usa en cada línea de los comprobantes electrónicos.

¿Cuántos dígitos tiene el código CAByS?

Trece.

¿Puedo usar el mismo CAByS para todo lo que vendo?

Solo si todo lo que vendés es realmente lo mismo. Cada producto o servicio lleva el código que lo describe, y de eso depende su IVA.

¿Qué hago si no encuentro mi producto?

Buscá por la categoría general del producto y elegí el código más específico que lo describa. Si tenés dudas, consultalo con tu contador.

En Facturaencr cada producto se guarda una vez con su CAByS y su tarifa, y el IVA se calcula solo en cada factura, desde el portal, el punto de venta o la API, que trae el buscador de CAByS incluido.