Skip to main content
POST
Validar un receptor contra el padrón de ARCA

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"

Body

application/json
taxpayerId
string
required

Bajo qué contribuyente se consulta. La consulta al padrón se hace con SU certificado de ARCA, así que el receptor queda asociado a él.

Example:

"cmfa1b2c30000"

documentType
enum<string>
required

Con qué documento se identifica el receptor. Sólo CUIT se puede validar contra el padrón: con DNI o consumidor final se guarda lo declarado sin consultar.

Available options:
CUIT,
DNI,
CONSUMIDOR_FINAL
Example:

"CUIT"

documentNumber
string
required

El número, sin guiones ni puntos. Con CONSUMIDOR_FINAL va 0.

Maximum string length: 20
Example:

"30500010912"

vatCondition
enum<string>
required

La condición frente al IVA declarada. Es lo que decide la letra del comprobante: a un responsable inscripto se le emite A, a un consumidor final o monotributista, B. Si el padrón la deduce, gana la del padrón.

Available options:
CONSUMIDOR_FINAL,
IVA_RESPONSABLE_INSCRIPTO,
IVA_SUJETO_EXENTO,
RESPONSABLE_MONOTRIBUTO
Example:

"IVA_RESPONSABLE_INSCRIPTO"

name
string

Nombre o razón social declarada. Si el padrón resuelve el CUIT, gana el del padrón: es el que ARCA espera ver en el comprobante.

Maximum string length: 255
Example:

"Cliente SA"

Response

El receptor guardado, y lo que dijo el padron. Un padronStatus distinto de OK no impide facturar: el receptor se guarda igual con lo declarado.

id
string
required

Id del cliente guardado. Se puede reusar en la emisión en vez de repetir sus datos.

Example:

"cms5182zy00hkurgsa6512cha"

documentType
number
required

80 CUIT, 86 CUIL, 96 DNI, 99 CF

Example:

80

documentNumber
string
required

El número del documento, sin guiones.

Example:

"30500010912"

name
string
required

El nombre que queda guardado. Si el padrón lo resolvió, gana el del padrón sobre el declarado: es el que ARCA espera ver.

Example:

"Cliente SA"

vatCondition
string
required

La que queda guardada, después de aplicar el criterio del padrón.

Example:

"IVA Responsable Inscripto"

padronStatus
string
required

Cómo salió la consulta al padrón. Que no sea OK no impide facturar: el receptor se guarda igual con lo declarado.

Example:

"OK"

padronMessage
string | null
required

El detalle cuando padronStatus no es OK.

padron
object | null
required

Lo que dijo el padrón, para poder mostrar la diferencia contra lo declarado en vez de pisarlo en silencio. null si no se pudo consultar.