Verificar la conexión con ARCA

curl --request POST \
  --url https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar \
  --header 'X-API-Key: <api-key>'

const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "estado": "FALTA_PUNTO_DE_VENTA",
  "detalle": "El punto de venta 1 no figura entre los habilitados para web service. ARCA informa: 3, 7. Dalo de alta en ARCA como \"Factura Electrónica - Web Service\", o configurá uno de esos.",
  "puntosDeVenta": [
    3,
    7
  ],
  "verificadoEn": "2026-08-11T20:15:00.000Z"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

Contribuyentes

Verificar la conexión con ARCA

Le pregunta a ARCA si la conexión está completa. No emite ningún comprobante: no consume número de serie ni tiene efecto fiscal.

⚠️ Pero no es de sólo lectura. Cuando el estado es DELEGACION_NO_VISIBLE, esta llamada dispara un trabajo que escribe en ARCA: Emissa entra a su Administrador de Relaciones y designa su Computador Fiscal para este contribuyente. El campo designacion te dice qué pasó con eso.

Decía sólo “sin emitir nada”, que es verdad sobre comprobantes y falso sobre ARCA. Un integrador lo leyó, lo puso a repetir, y doce verificaciones seguidas dispararon doce trabajos. No lo pongas en un useEffect que refresque solo. Hay un enfriamiento de 5 minutos del lado de Emissa —vas a ver designacion: "en-enfriamiento"— pero el enfriamiento es una red, no un permiso.

Antes, la forma de saberlo era intentar emitir y leer el rechazo — o sea descubrir que falta un punto de venta con un comprobante ya numerado.

Los estados posibles:

CONECTADO — ARCA responde y el punto de venta está habilitado.
FALTA_PUNTO_DE_VENTA — el detalle dice cuáles sí están.
DELEGACION_NO_VISIBLE — o no se autorizó a Emissa, o se autorizó después del ticket de acceso vigente. Son indistinguibles para ARCA, así que el detalle trae la fecha que las separa: si autorizaste después de ella, se completa solo.
SIN_INSCRIPCION_ACTIVA — el padrón no le registra IVA ni monotributo activos. Gana sobre todo lo demás: sin inscripción no puede tener punto de venta ni emitir, esté la autorización hecha o no.
SIN_CREDENCIAL — no hay certificado con el que firmar.
INDETERMINADO — ARCA no contestó. No quiere decir que algo esté mal.

Con DELEGACION_NO_VISIBLE la respuesta trae además ticketVigenteHasta: hasta ese momento una autorización recién hecha no puede verse, así que es cuándo tiene sentido volver a preguntar.

Consulta el catálogo de puntos de venta salteando el cache, así que refleja lo que ARCA dice ahora.

Scope de API key: taxpayer:read. Una key sin ese scope recibe 403 API_KEY_INSUFFICIENT_SCOPE, aunque el rol de quien la creó lo permita: el permiso efectivo es la intersección de los dos.

POST

taxpayers

{id}

conexion

verificar

Verificar la conexión con ARCA

curl --request POST \
  --url https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar \
  --header 'X-API-Key: <api-key>'

const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.emissa.com.ar/v1/taxpayers/{id}/conexion/verificar")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "estado": "FALTA_PUNTO_DE_VENTA",
  "detalle": "El punto de venta 1 no figura entre los habilitados para web service. ARCA informa: 3, 7. Dalo de alta en ARCA como \"Factura Electrónica - Web Service\", o configurá uno de esos.",
  "puntosDeVenta": [
    3,
    7
  ],
  "verificadoEn": "2026-08-11T20:15:00.000Z"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

{
  "statusCode": 401,
  "errorCode": "UNAUTHORIZED",
  "message": "No autorizado",
  "timestamp": "2026-07-26T18:30:00.000Z",
  "path": "/v1/invoices/authorize",
  "details": "<string>",
  "retryable": false,
  "retryAfterSeconds": 43200,
  "requestId": "0f2c1a5e-1d9b-4c7a-9a55-7f1a2b3c4d5e"
}

Authorizations

X-API-Key

string

header

required

API key de integración. El modo va en el prefijo: emi_test_ opera contra homologación, emi_live_ contra producción. Después, 64 hexadecimales.

Headers

X-Emissa-Producto

string

El producto que origina el pedido (inmos, por ejemplo). Opcional, sólo con API key. Formato ^[a-z0-9-]{1,32}$; otro valor da 400 INVALID_INPUT. Queda en el comprobante, en el consumo y en el registro de pedidos.

Con una key sin producto es sólo atribución: no autoriza ni restringe nada. Con una key atada a un producto el pedido se etiqueta con el de la key aunque no mandes la cabecera, y si mandás otro valor la respuesta es 403 API_KEY_PRODUCTO_DISTINTO.

Pattern: ^[a-z0-9-]{1,32}$

Example:

"inmos"

Path Parameters

string

required

Response

El diagnóstico, con un detalle para mostrarle a una persona.

estado

enum<string>

required

Qué le falta al contribuyente. INDETERMINADO no quiere decir que algo esté mal: quiere decir que ARCA no contestó y no se sabe.

Available options:

CONECTADO,

FALTA_PUNTO_DE_VENTA,

DELEGACION_NO_VISIBLE,

SIN_CREDENCIAL,

INDETERMINADO,

SIN_INSCRIPCION_ACTIVA

Example:

"FALTA_PUNTO_DE_VENTA"

detalle

string

required

Para mostrarle a una persona. Explica la consecuencia y el próximo paso, no el código interno de ARCA.

Example:

"El punto de venta 1 no figura entre los habilitados para web service. ARCA informa: 3, 7. Dalo de alta en ARCA como \"Factura Electrónica - Web Service\", o configurá uno de esos."

verificadoEn

string<date-time>

required

Cuándo se preguntó. La consulta saltea el cache, así que refleja lo que ARCA decía en este instante.

Example:

"2026-08-11T20:15:00.000Z"

puntosDeVenta

number[]

Los puntos de venta que ARCA informó. Vacío en homologación, donde ARCA nunca los informa — ahí no se puede concluir nada del punto de venta.

Example:

[3, 7]

cuitAAutorizar

string

La CUIT que el contribuyente tiene que autorizar en ARCA, en "Administrador de Relaciones de Clave Fiscal", para el servicio "Facturación Electrónica".

⚠️ Es la del ambiente de ESTE contribuyente, y los dos ambientes tienen CUIT distinta. Emissa firma con un certificado por ambiente. Llevar a ARCA la CUIT que devolvió una verificación de HOMOLOGACION para hacer el trámite de un contribuyente de PRODUCCION le otorga representación a quien no corresponde, y es una operación real que después hay que revocar. Sacá el número de la verificación del mismo contribuyente que vas a conectar.

Sólo viaja cuando falta hacer ese trámite (DELEGACION_NO_VISIBLE). Está aparte del detalle para que una integración pueda mostrarla en su propia pantalla sin parsear texto.

No se publica un ejemplo a propósito: un número de ejemplo en este campo se lee como la respuesta. El que había —20416564222— no coincidía con el que devuelve homologación, y un integrador frenó su prueba para preguntar cuál de los dos era el bueno. Hizo bien.

designacion

enum<string>

Qué pasó con la mitad del trámite que hace Emissa: designar su Computador Fiscal ante ARCA para este contribuyente. Sólo viaja con DELEGACION_NO_VISIBLE, que es cuando hay algo que designar.

lanzado — arrancó. Tarda ~90 segundos y no se espera: el resultado se sabe volviendo a verificar, o por el webhook connection.established.
ya-hay-uno — hay una corrida en curso y no se lanza otra. No es un error: esa corrida atiende a todos los pendientes, incluido éste.
en-enfriamiento — se lanzó hace menos de 5 minutos. Tampoco es un error, y es el que vas a ver si verificás seguido: el trabajo ya está hecho o en curso. La corrida anterior atiende a todos los pendientes, incluido uno que haya aparecido después de que arrancó, porque los recalcula al empezar.
no-disponible — no se pudo lanzar. El diagnóstico que estás leyendo es válido igual; lo que falta es el trabajo de Emissa, y es nuestro problema, no tuyo. Reintentar la verificación más tarde es lo correcto.

El campo existía y no estaba documentado: un integrador recibió no-disponible y no tenía cómo distinguir "no aplica acá" de "falló". Era lo segundo.

Available options:

lanzado,

ya-hay-uno,

en-enfriamiento,

no-disponible

Example:

"lanzado"

ticketVigenteDesde

string<date-time>

Cuándo se emitió el ticket de acceso de ARCA que está vigente.

Es la fecha que desempata un DELEGACION_NO_VISIBLE: la lista de quiénes autorizaron a Emissa viaja adentro del ticket, así que una autorización hecha después de este instante todavía no puede verse. Si se hizo antes, falta de verdad.

Example:

"2026-08-14T18:00:00.000Z"

ticketVigenteHasta

string<date-time>

Cuándo vence ese ticket: 12 horas después de emitido, y no se puede forzar ni revocar.

No es cuándo volver a preguntar — para eso está reintentarDesde, que llega unas once horas y tres cuartos antes. Esta descripción decía lo contrario, y era el texto anterior a que reintentarDesde existiera: un integrador siguió el campo equivocado y programó una espera de medio día para algo que tarda quince minutos.

Sólo viaja con DELEGACION_NO_VISIBLE, que es el único estado que el ticket explica.

Example:

"2026-08-15T06:00:00.000Z"

reintentarDesde

string<date-time>

Cuándo vuelve a tener sentido preguntar. No es ticketVigenteHasta, y confundirlos cuesta medio día de espera.

El vencimiento es el techo: el ticket se intenta renovar mucho antes, a los quince minutos de emitido, y un ticket nuevo trae la lista de delegaciones actual. Antes de este instante, verificar no le pregunta nada a ARCA — devuelve el ticket guardado sin salir a la red.

Medido: trámite en ARCA a las 14:28, ticket vigente de las 14:22:35, estado cambiado a las 14:43. Quince minutos, no las doce horas que sugería el vencimiento.

Puede estar en el pasado, y ahí significa que ya se intenta en cada verificación. Renovar igual puede fallar: ARCA se niega a emitir un ticket nuevo mientras el anterior siga dentro de su ventana, y en ese caso se sigue usando el vigente.

Example:

"2026-08-21T17:37:35.919Z"

firmadoCon

enum<string>

Con qué certificado se le habló a ARCA, y por lo tanto qué estados son siquiera posibles para este contribuyente.

plataforma — firma el certificado de Emissa en su nombre. La delegación importa y todos los estados pueden ocurrir.
propio — el contribuyente cargó el suyo. Autentica como sí mismo: no hay delegación en juego, así que DELEGACION_NO_VISIBLE no puede pasarle y revocar una autorización en ARCA no cambia nada para él.

Existe porque el diagnóstico contestaba CONECTADO sin decir cómo llegó ahí: los dos mecanismos se veían idénticos. Un integrador construyó una prueba sobre esa confusión y encuestó cinco horas esperando un cambio que era imposible.

Available options:

propio,

plataforma

Example:

"plataforma"

padron

object

Lo que ARCA dice de este contribuyente hoy, para poder detectar que se desfasó de lo que está guardado.

Si alguien pasa de monotributo a responsable inscripto y no avisa, la conexión no se rompe —el estado sigue CONECTADO, la delegación no tiene nada que ver— y se le sigue emitiendo la letra vieja hasta que se lo objetan. Comparando estos dos campos contra los guardados, se ve.

La comparación es de quien integra: acá viaja el hecho, no la conclusión.

Sólo en PRODUCCION y sólo si el padrón contestó. En homologación no se consulta a propósito: ese padrón no describe al contribuyente real, y afirmar algo sobre su situación fiscal con datos de prueba sería peor que no decir nada.

Show child attributes

Contribuyentes

Credenciales ARCA

Clientes

Comprobantes

Consumo

Verificar la conexión con ARCA

Authorizations

Headers

Path Parameters

Response