Las listas de códigos de ARCA

¿Qué son y para qué sirven?

ARCA maneja todo con códigos, no con nombres. Una Factura B no es "B" para ARCA: es el 6. El DNI no es "DNI": es el 96. El 21% de IVA es el 5. Cuando facturás, tenés que mandar esos números, no el texto.

Estos endpoints te traen las listas oficiales y al día de todos esos códigos. Los usás para dos cosas típicas:

• Llenar los combos de tu sistema (el desplegable de "tipo de comprobante", el de "tipo de documento", etc.) con lo que ARCA realmente acepta.
• Validar que un valor que vas a mandar existe y es correcto antes de facturar.

Todas se usan igual

Esta es la parte buena: los 10 endpoints funcionan exactamente igual. Aprendés el patrón una vez y lo aplicás a todos.

Lo que mandás

{
  "cuit": 20111111112,
  "produccion": false
}

cuit es el tuyo (sin guiones, como número). produccion: false = homologación (pruebas), true = producción (el real).

Lo que recibís

Como en toda la API, viene con el sobre { ok, data }. La regla de oro: primero mirás ok; si es true, la lista está en data.

{
  "ok": true,
  "data": [
    { "Id": 1,  "Descripcion": "Factura A" },
    { "Id": 6,  "Descripcion": "Factura B" },
    { "Id": 11, "Descripcion": "Factura C" },
    { "Id": 3,  "Descripcion": "Nota de Crédito A" }
  ]
}

El Id es el código que después mandás cuando facturás; la Descripcion es lo que le mostrás al usuario en pantalla.

Las 10 tablas

Todas cuelgan de /api/afip/ y responden con el mismo formato de arriba. Cambia solo qué lista te traen:

Seguir