Errores
Todas las respuestas de error son { "code", "message" } (más observaciones en los rechazos de ARCA).
| HTTP | code | Qué hacer |
|---|---|---|
| 400 | VALIDATION_ERROR | Corregir el request (el message dice qué campo). Key nueva solo si cambiás los datos. |
| 401 | — | API key inválida o ausente. |
| 402 | PRODUCCION_REQUIERE_PLAN_PAGO | La cuenta no tiene producción habilitada. |
| 403 | ENTORNO_NO_PERMITIDO | La API key no puede emitir en ese entorno. Usá otra key o cambiá sus entornos en el portal. |
| 403 | SIN_PERMISO | (portal, equipo) El rol de la persona en esa cuenta no permite la operación. Una API key es de la cuenta: puede todo. |
| 404 | NO_ENCONTRADO | (consulta) No hay emisión guardada para esa key. |
| 422 | CREDENTIAL_ERROR | Certificado inválido, vencido, sin autorizar en ARCA, o no hay uno guardado para ese CUIT/entorno. No reintentar sin corregir. |
| 422 | COMPROBANTE_RECHAZADO | ARCA no lo aprobó; ver observaciones. Corregir y emitir con key nueva. |
| 422 | RECONCILIACION_FALLIDA | El número reservado lo usó otro comprobante. No se emitió nada. No reintentar: revisión manual. |
| 422 | SALDO_INSUFICIENTE | La nota de crédito supera el saldo de la factura. No se emitió. |
| 422 | DATOS_EMISOR_FALTANTES | (PDF) Faltan los datos para la factura de ese CUIT: cargalos en el portal (Perfil → Datos para la factura). |
| 429 | RATE_LIMIT | Cuota de la cuenta excedida: esperar y reintentar con la misma key. |
| 429 | LIMITE_FACTURACION | El comprobante supera el tope de la API key. No se emitió: no reintentar hasta el próximo período o subir el límite. |
| 503 | ARCA_UNAVAILABLE | ARCA caído, timeout o corte de red. Reintentar con la misma key. |
| 503 | VAULT_NO_CONFIGURADO | El servidor no tiene la bóveda habilitada: mandar certPem/keyPem. |
| 503 | EMAIL_NO_CONFIGURADO | (enviar) El servidor no tiene configurado el envío de mails. |
| 503 | EMAIL_NO_ENVIADO | (enviar) El proveedor de mails falló: reintentar en unos minutos. |