¿Qué es el código CABYS y por qué son 13 dígitos?

CABYS son las siglas de Catálogo de Bienes y Servicios. Lo mantiene el Banco Central de Costa Rica junto con Hacienda, y le asigna a cada bien o servicio un código único de 13 dígitos. Cuando emitís una factura, cada línea tiene que llevar el CABYS del producto que vendés.

Los 13 dígitos son jerárquicos: van de lo general a lo específico.

• Los primeros dígitos ubican la categoría general (por ejemplo, alimentos, servicios profesionales, construcción).
• Los dígitos intermedios afinan el grupo y la clase.
• Los últimos identifican el bien o servicio puntual.
• A cada código le corresponde una tarifa de IVA en el catálogo del BCCR.

El catálogo completo ronda los 20.506 códigos. Elegir el correcto es la diferencia entre una factura aceptada y una rechazada.

La duda más común es "¿le cobro 13% o menos?". En Costa Rica eso no lo decidís vos por intuición: lo decide el CABYS. Cada código trae asociada su tarifa — 13% general, o las reducidas de 4%, 2% y 1% (canasta básica), además de bienes y servicios exentos o al 0%. Por eso el CABYS correcto te evita cobrar de más o de menos.

Desde la versión 4.4 de comprobantes electrónicos, el CABYS es obligatorio en cada línea de detalle: no podés facturar un producto sin su código de 13 dígitos. El catálogo lo publica y mantiene el Banco Central, y se actualiza periódicamente —la actualización más reciente entró a regir en junio de 2026, con códigos que cambian de descripción o tarifa.

• El CABYS es campo obligatorio por línea en el XML v4.4.
• Debe existir en el catálogo oficial vigente; uno inventado o dado de baja se rechaza.
• La tarifa de IVA que declarás tiene que ser coherente con la del CABYS.
• Cuando el BCCR actualiza el catálogo, conviene revisar los códigos que ya usabas.

Para el panorama completo de qué cambió y desde cuándo, mirá facturación electrónica 4.4 en Costa Rica.

Hacienda valida el CABYS contra su catálogo. Hay dos formas típicas de caer:

• CABYS inexistente (mal tecleado, con menos de 13 dígitos o dado de baja) → rechazo directo del comprobante.
• CABYS que existe pero no corresponde al producto → tarifa de IVA incoherente y riesgo de inconsistencia en los totales.

Lo caro del rechazo no es solo repetir la factura: es que descubrís el problema después de haber cobrado. El catálogo de los rechazos más frecuentes, con la causa y cómo evitarlos, lo tenés acá: errores de rechazo de Hacienda v4.4.

Plaxp trae el catálogo CABYS completo (~20.506 códigos) integrado, y lo trabaja en dos momentos:

• Buscás y elegís el código desde el panel o por API: buscás por texto o categoría y Plaxp te devuelve la descripción y la tarifa de IVA de cada CABYS, para que apliques la correcta.
• Valida antes de enviar: si el CABYS de una línea no existe en el catálogo, Plaxp lo detecta y frena el envío sin quemar el consecutivo, y te dice exactamente qué línea está mal (reporta todas las que fallan, no solo la primera).
• Clasifica bien o servicio según el catálogo oficial del BCCR, para que el resumen de la factura cuadre y no te lo rechacen por ahí.

La búsqueda de códigos es un endpoint público del API; podés integrarlo en tu POS o e-commerce sin fricción:

curl 'https://api.plaxp.com/api/codigos-cabys?buscar=arroz'
# → { success, data: [
#     { codigo: "0111301000000", descripcion: "Arroz ...",
#       categoria: "...", tarifa_impuesto: 1, estado: "activo" }, ...
#   ], pagination: { ... } }

¿Querés ver el flujo completo de emisión? API de facturación electrónica.