Chequeá antes de facturar

¿Qué es y para qué sirve?

/ping te dice, antes de intentar facturar, si "hay línea" con los servidores que vas a necesitar. En vez de lanzar una operación contra ARCA y esperar a que falle porque no hay internet o porque ARCA está caído, primero preguntás "¿está todo accesible?" y con esa respuesta decidís si seguís o esperás.

Chequea dos cosas de cada servidor:

• Que se pueda abrir una conexión (o sea, que sea alcanzable).
• Cuánto tarda en responder — la latencia, en milisegundos.

La respuesta es instantánea

afiPAPI no hace el chequeo en el momento en que preguntás. Tiene un proceso interno que va midiendo la conectividad solo, cada 30 segundos, y guarda el último resultado. Cuando preguntás, te devuelve ese dato ya guardado, sin que esperes nada. Por eso podés consultarlo seguido sin penalización.

Dos formas de llamarlo

Los dos devuelven exactamente el mismo formato de respuesta. El GET es el atajo cómodo; el POST es el que te da las opciones.

Las opciones del request (POST)

El JSON que mandás tiene 3 campos, todos con un valor por defecto sensato:

{
  "produccion": false,
  "incluirAfip": true,
  "destinos": [ ... ]
}

produccion — opcional, default false

Elige contra qué ambiente de ARCA se mide. false = homologación (pruebas); true = producción (el real). Importa porque homo y prod son máquinas distintas: puede estar arriba una y caída la otra.

incluirAfip — opcional, default true

Dice si en la respuesta querés que vengan los servidores de ARCA (WSAA + WSFE) o no. Ponelo en false cuando querés chequear únicamente algo tuyo, sin arrastrar el chequeo de ARCA.

destinos — opcional, una lista

Acá va la consulta personalizada: uno o varios servidores tuyos a chequear. Cada destino es un objeto con estos campos:

Ejemplos de cada combinación

A) Solo ARCA, homologación — el caso típico

GET /api/afip/ping?produccion=false

B) Solo ARCA, producción

GET /api/afip/ping?produccion=true

C) ARCA + tu MySQL — las dos cosas de una

{
  "destinos": [
    { "nombre": "MySQL caja", "host": "10.0.0.5", "puerto": 3306, "tipo": "mysql" }
  ]
}

D) Solo tu MySQL, sin ARCA

{
  "incluirAfip": false,
  "destinos": [
    { "nombre": "MySQL caja", "host": "10.0.0.5", "puerto": 3306 }
  ]
}

Acá omití tipo: como el puerto es 3306, lo toma como mysql igual.

E) Varios servidores tuyos a la vez

{
  "incluirAfip": false,
  "destinos": [
    { "nombre": "MySQL",            "host": "10.0.0.5",     "puerto": 3306, "tipo": "mysql" },
    { "nombre": "Mi web",           "host": "miapp.com",    "puerto": 443,  "tipo": "tcp" },
    { "nombre": "Impresora fiscal", "host": "192.168.1.50", "puerto": 9100 }
  ]
}

La respuesta, campo por campo

{
  "ok": true,
  "data": {
    "fecha": "2026-07-23T10:15:03",
    "produccion": false,
    "afipAccesible": true,
    "objetivos": [
      {
        "nombre": "WSAA", "grupo": "afip",
        "host": "wsaahomo.afip.gov.ar", "puerto": 443, "tipo": "tcp",
        "accesible": true, "latenciaMs": 84, "servidor": null, "error": null,
        "fechaChequeo": "2026-07-23T10:14:51", "edadSegundos": 12
      },
      {
        "nombre": "MySQL caja", "grupo": "custom",
        "host": "10.0.0.5", "puerto": 3306, "tipo": "mysql",
        "accesible": true, "latenciaMs": 3, "servidor": "MySQL 8.0.36", "error": null,
        "fechaChequeo": "2026-07-23T10:14:51", "edadSegundos": 12
      }
    ]
  }
}

A nivel general

De cada objetivo

Cuando algo está mal en el request

Si mandás un destino incompleto o inválido, la API te lo dice con ok:false y un status HTTP:

Cómo lo usás en la práctica

Seguir