ARCA {API}
CUITs y certificados

Reverificar contra ARCA

Volvé a preguntarle a ARCA por el punto de venta y la constancia de un CUIT después de que tu cliente hizo un trámite.

POST /api/cuits/{cuit}/{environment}/verificar

Vuelve a consultar a ARCA dos cosas que pueden cambiar sin que nos enteremos, porque ocurren dentro de ARCA:

  • El punto de venta: si el guardado está habilitado para Web Services, o —si no hay ninguno guardado y ARCA habilita uno solo— cuál es.
  • La constancia de inscripción: si el certificado de producción del CUIT está autorizado para ws_sr_constancia_inscripcion, y con eso, la situación fiscal del contribuyente (razón social, domicilio fiscal, condición fiscal).

Usalo cuando tu cliente te avise que resolvió un paso pendiente —delegó la constancia, habilitó el punto de venta— para que pasosPendientes lo refleje.

curl -X POST https://arca.api.com.ar/api/cuits/20123456789/produccion/verificar \
  -H "Authorization: Bearer ak_TuSecretoAqui"

Sin body. Requiere scope read_write, porque actualiza lo que sabemos del CUIT.

Respuesta exitosa

Status: 200 · El objeto CUIT actualizado. Por ejemplo, si tu cliente acaba de delegar la constancia, delegar_constancia deja de figurar:

{
  "cuit": "20123456789",
  "environment": "produccion",
  "estado": "vigente",
  "pasosPendientes": [],
  "ptoVta": 4,
  "ptoVtaHabilitado": true,
  "constanciaAutorizada": true,
  "...": "..."
}

Si ARCA no responde, la respuesta sigue siendo 200 y conserva los valores anteriores: sólo marcamos algo como no autorizado o no habilitado cuando ARCA lo dice explícitamente, nunca por una caída.

No consume cuota ni cuenta como consumo en el dashboard, aunque consulte a ARCA. Cada llamada hace un par de consultas al organismo, así que llamalo cuando haya un motivo —tu cliente avisó que hizo algo—, no en un loop.

La constancia se consulta siempre con el certificado de producción del mismo CUIT —igual que en el dashboard—, también cuando reverificás la entrada de homologación. Si el CUIT no tiene certificado de producción, constanciaAutorizada no cambia.

Errores

StatusDescripción
401API key ausente, inválida o revocada
403La API key es de solo lectura
404El CUIT no existe en ese entorno, es de otra cuenta o fue dado de baja
409El CUIT no tiene certificado activo en ese entorno: primero hay que cargarlo

En esta página