Catálogo de errores

Todos los errores que puede devolver la API, ordenados por code. El formato de la respuesta está en Convenciones.

• Manejá los errores por code, que es estable. El texto de detail puede cambiar.
• detail completa los %s del mensaje con datos del caso: la columna de la derecha es un ejemplo.
• La misma lista está disponible en JSON, sin autenticación, en GET /errors.

code	Status	Nombre	Ejemplo de detail
40001003	400	CATALOG_NOT_FOUND	Catálogo no soportado: tipos-comprobante
40001004	400	STATIC_CATALOG_NOT_FOUND	Catálogo estático no soportado: provincias
40001005	400	CANNOT_DELETE_SELF_REPRESENTED_CUIT	No se puede eliminar el RepresentedCuit propio (isSelf) de una credential
40001009	400	USER_CUIT_NOT_CONFIGURED	El usuario no tiene un CUIT configurado
40001016	400	TOTAL_AMOUNT_MISMATCH	total_amount debe ser igual a taxable_amount + non_taxable_amount + exempt_amount + vat_amount + other_taxes_amount
40001017	400	VAT_AMOUNT_MISMATCH	vat_amount debe ser igual a la suma de vat_items[].amount
40001018	400	OTHER_TAXES_AMOUNT_MISMATCH	other_taxes_amount debe ser igual a la suma de tax_items[].amount
40001019	400	SERVICE_DATES_REQUIRED	service_start_date, service_end_date y payment_due_date son obligatorios para este concept_type
40001020	400	TOURISM_VOUCHER_ONLY_SURPLUS_ITEMS	Un comprobante de turismo no puede tener únicamente ítems con tourism_code=5 (Excedente)
40001021	400	ISSUE_DATE_OUT_OF_RANGE	issue_date debe estar dentro de 5 días de la fecha actual
40001031	400	CERT_DOES_NOT_MATCH_GENERATED_KEY	El certificado no corresponde a la clave generada por este sistema
40001032	400	INVALID_CERT_PEM	El PEM del certificado no es válido
40001048	400	ITEMS_REQUIRED_FOR_ITEMIZED_INVOICE	items es obligatorio: el emisor está adherido a RG 2904, este comprobante necesita el detalle de ítems
40101037	401	MISSING_BEARER_TOKEN	Falta el header Authorization con un Bearer token
40101038	401	INVALID_TOKEN	El token es inválido o expiró
40101039	401	SIGNING_KEY_NOT_FOUND	No se encontró la clave pública para verificar el token (kid)
40101040	401	JWKS_FETCH_FAILED	No se pudieron obtener las claves públicas para verificar el token
40101041	401	MISSING_API_CLIENT_TOKEN	Falta el header Authorization con un token de Api Client
40101042	401	INVALID_API_CLIENT	El Api Client es inválido o fue revocado
40301008	403	CREDENTIAL_REVOKED	La credential asociada fue revocada
40301027	403	CREDENTIAL_PENDING_CERT	La credential todavía no tiene certificado (PENDING_CERT)
40301028	403	CREDENTIAL_EXPIRED	La credential expiró
40401002	404	RESOURCE_NOT_FOUND	recurso no encontrado
40401007	404	REPRESENTED_CUIT_NOT_FOUND	RepresentedCuit no encontrado
40401015	404	INVOICE_NOT_FOUND	Comprobante no encontrado
40401022	404	CREDENTIAL_NOT_FOUND	Credential no encontrada
40401024	404	PLATFORM_CREDENTIAL_SECRET_NOT_FOUND	No hay clave ni certificado guardados para la credential de plataforma
40401033	404	USER_NOT_FOUND	Usuario no encontrado
40401035	404	API_CLIENT_NOT_FOUND	Api Client no encontrado
40401036	404	CONTRIBUYENTE_NOT_FOUND	ARCA no devolvió constancia para este CUIT
40401050	404	CBU_SALES_POINT_NOT_FOUND	No se encontró ese punto de venta marcado como CBU informada
40901006	409	REPRESENTED_CUIT_HAS_INVOICES	No se puede eliminar el RepresentedCuit: tiene comprobantes asociados
40901011	409	INVOICE_NOT_REJECTED	Solo se puede reintentar un comprobante REJECTED
40901012	409	INVOICE_REJECTED_NO_PDF	Un comprobante REJECTED no tiene PDF (nunca tuvo autorización)
40901013	409	INVOICE_PDF_NOT_SUPPORTED_FOR_SERVICE	El PDF todavía no está soportado para este tipo de comprobante
40901014	409	INVOICE_NOT_AUTHORIZED	El comprobante no tiene autorización de ARCA todavía
40901023	409	PLATFORM_CREDENTIAL_ALREADY_EXISTS	Ya existe una credential de plataforma
40901025	409	PLATFORM_CREDENTIAL_STILL_PENDING	La credential de plataforma todavía no tiene certificado
40901026	409	CREDENTIAL_ALREADY_ACTIVE	La credential ya tiene un certificado activo
40901029	409	PLATFORM_CREDENTIAL_SECRET_EXISTS_USE_RECOVER	La credential de plataforma ya tiene clave y certificado guardados — hay que recuperarla, no pedir un CSR nuevo
40901034	409	CUIT_ALREADY_CONFIGURED	El usuario ya facturó con este CUIT confirmado por ARCA — ya no se puede modificar
40901049	409	CBU_SALES_POINT_ALREADY_EXISTS	Este punto de venta ya está marcado como CBU informada para este cliente
50001030	500	CREDENTIAL_SECRET_MISSING	La credential existe pero no se encontró su clave privada
50001043	500	CREDENTIAL_STORE_OPERATION_FAILED	No se pudo completar la operación sobre las credenciales guardadas — reintentá más tarde
50001044	500	ARCA_BUSINESS_ERROR	ARCA rechazó la operación — revisá los datos del comprobante e intentá de nuevo
50001045	500	ARCA_HTTP_ERROR	ARCA no está disponible en este momento — reintentá más tarde
50001046	500	ARCA_UNEXPECTED_RESPONSE	ARCA devolvió una respuesta que no se pudo interpretar — reintentá más tarde
50001047	500	API_CLIENT_OPERATION_FAILED	No se pudo completar la operación sobre el API Client — reintentá más tarde
50301001	503	SERVICE_UNAVAILABLE	El servicio no está disponible en este momento
50301010	503	PLATFORM_CREDENTIAL_NOT_CONFIGURED	No hay ninguna credential de plataforma activa configurada