🇨🇷 Costa Rica
Esta ficha asume que conoces el protocolo de comunicación xPOS-Core. Aquí solo documentamos lo especifico de Costa Rica.
Resumen
| Aspecto | Valor |
|---|---|
Código country | cr |
| Entidad tributaria | Ministerio de Hacienda (MH) |
| Patrón | A — XML con XSD |
inputType soportados | json, xml, xdoc, txt |
| Endpoint extra | – |
| Output | XML tributario firmado |
Mapeo de XSLT
| XSLT | Uso |
|---|---|
input_to_dte_cr.xslt | Entradas json y xml → XML <root> → XML Gosocket. |
other_to_dte_cr.xslt | Entrada txt → XML Gosocket. No pasa por input_to_dte. |
xdoc_to_dte_cr.xslt | Entrada xdoc → XML Gosocket. No pasa por input_to_dte. |
dte_to_fiscal_cr.xslt | XML Gosocket → DTE tributario MH. |
custom_response_cr.xslt | Genera custom_response cuando aplica. |
Tipos de documento (typeDoc)
Ejemplo WebSocket usa
typeDoc=1. El parámetro es numérico:typeDoc=1ytypeDoc=01son equivalentes.
typeDoc | Documento |
|---|---|
| 01 | Factura electrónica |
| 02 | Nota de débito electrónica |
| 03 | Nota de crédito electrónica |
| 04 | Tiquete electrónico |
| 08 | Factura electrónica de compras |
| 09 | Factura electrónica de exportación |
| 10 | Recibo electrónico de pago |
Cada tipo valida contra su propio esquema, en la versión 4.4.
Campos del response específicos de Costa Rica
Costa Rica devuelve todo el nucleo + eco tributario completo (statusCode/Description/Message) + applicationResponse + timeGeneration + timeValidation.
countryIdentificationCode en Costa Rica corresponde a la clave numérica MH (50 dígitos).
Ejemplo WebSocket
Valores ilustrativos. La estructura es real; los datos son ejemplos.
{
"env": "sbx",
"operation": "consolidate",
"typeDoc": 1,
"country": "cr",
"inputType": "json",
"origin": "<taxId del emisor>",
"document": { /* DTE Costa Rica */ }
}Notas particulares
- Publica en Inbox-Gosocket.
- Reobtención vía
/api/v1/statuscontransactionIdofolio + typeDoc.
Cambios en la versión 2.7.0
- Renovación de credenciales más robusta ante Hacienda: se ejecuta una sola renovación de token a la vez —aunque varios envíos la necesiten al mismo tiempo— y la vigencia se lee del propio token. Menos rechazos por credencial vencida en momentos de alta actividad.
- Contingencia más resiliente: una interrupción de conexión con Hacienda ya no afecta al documento; queda en espera y se reenvía automáticamente al recuperarse el servicio. El estado final se refleja cuando la autoridad responde.