Documentación / Referencia

Errores

Los errores llegan de dos lugares distintos: los que genera RECE.API antes de contactar a AFIP, y los que devuelve AFIP al procesar el comprobante. Saber cuál es cuál acorta mucho el diagnóstico.

Dónde mirar

El código HTTP no alcanza. Un rechazo de AFIP puede llegar con 200 y success: false en el cuerpo. Revisá siempre estos tres campos:

{
  "success": false,
  "errorMessage": "[10016] El punto de venta 9 no esta dado de alta en AFIP",
  "errores": [
    { "codigo": 10016, "mensaje": "El punto de venta 9 no esta dado de alta en AFIP" }
  ],
  "observaciones": []
}

Códigos HTTP de la API

Validaciones previas

Se rechazan con 400 antes de llamar a AFIP, así que no consumen tiempo de red:

Códigos de error de AFIP

Problemas frecuentes

"No se pudo obtener autenticación"

El certificado no se pudo usar. En orden de probabilidad:

1. No está autorizado en AFIP para ese web service. Es la causa más común. La autorización es por servicio: wsfe, wsfex y wsremcarne se habilitan por separado.
2. Venció. Verificalo con el diagnóstico de certificado.
3. La contraseña del .pfx es incorrecta.
4. El archivo no incluye la clave privada. Al exportarlo desde el navegador o desde OpenSSL, hay que incluirla explícitamente.
5. El reloj del servidor está desfasado respecto del de AFIP.

Para aislarlo, probá primero la autenticación sola:

curl "https://api.tudominio.com/api/monitor/empresa/30712345678/ping-wsaa?ambiente=produccion"

El comprobante se emitió pero no recibí el CAE

Pasa cuando la conexión se corta después de que AFIP autorizó. El comprobante existe y volver a emitir generaría un duplicado.

La forma de recuperarlo es reintentar la misma llamada enviando el numeroComprobante explícito: si ese número ya tiene CAE, la API lo devuelve con esConsultaExistente: true en vez de emitir de nuevo. Alternativamente, consultá el comprobante con /api/facturacion/consultar.

Saltos de numeración

AFIP exige numeración correlativa. Si tu sistema lleva su propio contador y se desincroniza, vas a recibir rechazos. La respuesta incluye numeroEsperado con el número que correspondía según el último autorizado. Consultá el último número antes de emitir.

"Input string was not in a correct format"

Un problema de formato numérico. AFIP espera punto decimal (1210.00), no coma. Enviá los importes como números JSON, no como strings: "importeTotal": 1210.00, nunca "importeTotal": "1210,00".

Errores de comunicación sin causa aparente

Si un comprobante falla de forma inexplicable y otros similares pasan, revisá los campos de texto libre. tributos[].descripcion, opcionales[].valor y los campos de cliente en WSFEX se insertan en el XML sin escapar: un & en una razón social rompe el mensaje. Sanitizá esos campos antes de enviarlos.

Emití en producción y aparece en homologación

Revisá el valor exacto de ambiente. Cualquier cosa que no sea exactamente produccion — un "prod", un acento de más, un espacio — resuelve silenciosamente a homologación y devuelve un CAE que parece válido pero no tiene efecto fiscal.

Checklist de diagnóstico

Antes de escalar un problema, verificá:

Reportar un problema

Si después del checklist el error sigue, para poder ayudarte hacen falta:

1. El request completo, con la contraseña del certificado y el token censurados.
2. La respuesta completa, incluidos errores[] y observaciones[].
3. El ambiente y el CUIT emisor.
4. La fecha y hora aproximadas, para cruzar contra los logs del servidor.