Consultar un contribuyente

Antes de emitir, puedes completar los datos del receptor consultándolos en el padrón del ente tributario: el del SII en Chile y el padrón A5 de ARCA (constancia de inscripción) en Argentina.

curl "https://api.emify.co/api/taxpayers/AR/20111111112" \
  -H "X-Api-Key: tu_api_key"

País	`country`	`documentNumber`
Chile	`CL`	RUT con guion: `76354771-9`
Argentina	`AR`	CUIT con o sin guiones: `20111111112` o `20-11111111-2`

El código de país es ISO 3166-1 alfa-2 y no distingue mayúsculas. Cualquier otro país responde 400.

Qué devuelve

La respuesta tiene la misma forma para todos los países. Lo que el padrón de un país no informa viene en null.

Campo	Chile	Argentina
`document_number`	RUT tal como está en el padrón	CUIT de 11 dígitos, sin guiones
`legal_name`	Razón social	Razón social; en una persona física, `APELLIDO NOMBRE`
`primary_activity`, `activities`	Actividades económicas	`null`
`email`	Casilla de intercambio de DTE	`null`
`address`	Domicilio con los campos de `recipient.address`	El domicilio fiscal, con los campos de `recipient.address`
`addresses`	`null`	Todos los domicilios que publica el padrón
`taxes`	`null`	Impuestos en los que está inscripto hoy
`tax_condition`	`null`	Condición IVA: `RI`, `EX`, `MT` o `NAL`, o `null` si no se puede determinar

address tiene los mismos campos que recipient.address al emitir, con el mismo significado:

Campo	Chile	Argentina
`address`	Calle y número en una línea; block, departamento y villa siguen separados por coma	Calle, número y unidad, tal como los publica ARCA
`city`	Comuna	Localidad. En la Ciudad de Buenos Aires el padrón no la informa y viene en `null`
`state`	Código ISO 3166-2 de la región (`CL-RM`)	Código ISO 3166-2 de la provincia (`AR-Q`)
`country`	`CL`	`AR`

Si el padrón no permite determinar la región o la provincia, state viene en null.

{
  "document_number": "76354771-9",
  "legal_name": "EMPRESA EJEMPLO SPA",
  "primary_activity": "VENTA AL POR MAYOR NO ESPECIALIZADA",
  "activities": ["VENTA AL POR MAYOR NO ESPECIALIZADA"],
  "email": "FacturacionMIPYME@sii.cl",
  "address": { "address": "AV PROVIDENCIA 1234, OFICINA 501", "city": "LAS CONDES", "state": "CL-RM", "country": "CL" },
  "addresses": null,
  "taxes": null,
  "tax_condition": null
}

{
  "document_number": "20111111112",
  "legal_name": "PEREZ JUAN",
  "primary_activity": null,
  "activities": null,
  "email": null,
  "address": { "address": "LAGUNA LOS SAUCES 2", "city": "JUNIN DE LOS ANDES", "state": "AR-Q", "country": "AR" },
  "addresses": [
    { "type": "FISCAL", "address": "LAGUNA LOS SAUCES 2", "city": "JUNIN DE LOS ANDES", "state": "AR-Q", "postal_code": "8371" }
  ],
  "taxes": [
    { "code": "30", "description": "IVA" }
  ],
  "tax_condition": "RI"
}

En Argentina, taxes lista solo los impuestos activos. Un impuesto dado de baja, exento o en trámite no aparece.

En Chile, email es la casilla donde el contribuyente recibe documentos electrónicos, no un correo de contacto comercial. Suele ser la casilla del portal gratuito del SII o la de su proveedor de facturación, y la comparten miles de contribuyentes. Por eso no está dentro de address: recipient.address.email es un correo de contacto.

Usar el resultado para emitir

El resultado se copia al recipient de la factura sin traducir nombres ni códigos:

address va entero en recipient.address.
En Argentina, tax_condition va en recipient.tax_information.tax_condition.

"recipient": {
  "legal_name": "PEREZ JUAN",
  "document_type": "CUIT",
  "document_number": "20111111112",
  "address": { "address": "LAGUNA LOS SAUCES 2", "city": "JUNIN DE LOS ANDES", "state": "AR-Q", "country": "AR" },
  "tax_information": { "tax_condition": "RI" }
}

tax_condition se deduce de los impuestos activos del padrón:

Impuesto activo	`tax_condition`
`30` IVA	`RI`
`32` IVA EXENTO	`EX`
`20` MONOTRIBUTO	`MT`
`34` IVA NO ALCANZADO	`NAL`
Ninguno de los cuatro, o más de uno	`null`

tax_condition es un punto de partida, no la condición declarada. ARCA la registra junto al CAE y no se puede corregir después, así que confírmala antes de emitir. El padrón no permite distinguir a un monotributista social o promovido: se informan como MT. Cuando el padrón no permite deducir la condición, el valor es null y no CF.

Antigüedad de los datos

Los datos pueden tener hasta 7 días de antigüedad. Emify guarda la respuesta del padrón y no vuelve a consultar al ente tributario por ese contribuyente hasta que pasa una semana. Si un contribuyente cambió su domicilio o se inscribió en un impuesto en los últimos días, puede que todavía no se vea.

Errores

Código HTTP	`code`	Qué significa
`400`	`UNSUPPORTED_COUNTRY`	El país no se puede consultar
`404`	`TAXPAYER_NOT_FOUND`	El padrón no tiene ese contribuyente, o el CUIT tiene el dígito verificador mal
`503`	`TAXPAYER_LOOKUP_UNAVAILABLE`	El padrón del ente tributario no está disponible. Puedes reintentar más tarde

Cómo funciona

Configuración de la empresa

Emisión y recepción

Consultar un contribuyente

Qué devuelve

Usar el resultado para emitir

Antigüedad de los datos

Errores

​Qué devuelve

​Usar el resultado para emitir

​Antigüedad de los datos

​Errores

Qué devuelve

Usar el resultado para emitir

Antigüedad de los datos

Errores