Consultar contribuyentes

Antes de emitir una factura a una empresa necesitás su condición frente al IVA: define la clase del comprobante y el receptor que informás. El Padrón de ARCA la tiene, y client.padron te la devuelve en el mismo formato que acepta to.condition.

import { createArcaClient } from "facturas";

const arca = createArcaClient();

const contribuyente = await arca.padron.getTaxpayerDetails("20123456786");

if (contribuyente?.condition) {
  const resultado = await arca.issue({
    issuer: "responsable_inscripto",
    salesPoint: 3,
    to: { condition: contribuyente.condition, cuit: contribuyente.taxId },
    items: [{ net: 100_000, vat: 21 }],
  });
}

El ejemplo completo está en examples/consultar-contribuyente.ts.

Habilitar los servicios

El Padrón son dos servicios de ARCA distintos de Facturación Electrónica, y el certificado tiene que estar autorizado para cada uno que uses:

Método	Servicio de ARCA
`getTaxpayerDetails(cuit)`	`ws_sr_constancia_inscripcion`
`getTaxIdByDocument(documento)`	`ws_sr_padron_a13`

Es el mismo certificado y el mismo trámite que hiciste para wsfe, repetido por servicio. En homologación, otra autorización a servicio en el WSASS. En producción, otra relación en el Administrador de Relaciones para el mismo computador fiscal. Los pasos de cada entorno están en Habilitación en ARCA. npx facturas check prueba solo wsfe. Si el certificado no está autorizado para un servicio del Padrón, la llamada lanza ArcaAuthenticationError, como explica Errores.

Datos del contribuyente

getTaxpayerDetails() consulta la constancia de inscripción y devuelve:

Campo	Qué trae
`taxId`	El CUIT, como string de 11 dígitos
`personType`	`FISICA` o `JURIDICA`, cuando ARCA lo informa
`name`	La razón social, o el apellido y nombre de una persona física
`address`	El domicilio fiscal: `street`, `city`, `postalCode`, `provinceId` y `province`. Cada campo aparece solo si ARCA lo informa
`condition`	La condición de receptor para `to.condition`, cuando se puede decidir
`taxes`	Cada impuesto informado, con `id`, `description`, `state` y `regime`
`activities`	Cada actividad económica, con `id`, `description`, `order`, `since` y `regime`
`errors`	Los errores de la constancia, como un domicilio sin resolver. Vacío si no hay
`raw`	La respuesta completa de ARCA, para lo que el SDK no normaliza

Devuelve null cuando ARCA dice que el CUIT no existe. Cualquier otro error del servicio se lanza. provinceId es el código de provincia de ARCA, donde 0 es la Ciudad de Buenos Aires. El id de una actividad es el código NAES de seis dígitos, como string y con ceros a la izquierda, por ejemplo "011211". order 1 es la actividad principal y since es el período de alta, YYYY-MM. Una actividad inscripta a la vez en actividad y actividadMonotributista aparece una sola vez.

const contribuyente = await arca.padron.getTaxpayerDetails("20123456786");

if (contribuyente?.errors.length) {
  console.warn(contribuyente.errors.join(", "));
}
console.log(contribuyente?.address?.city, contribuyente?.activities[0]?.id);

Cómo se decide `condition`

condition sale de las inscripciones activas en IVA:

Impuesto	`condition`
30	`responsable_inscripto`
20	`monotributo`
32	`exento`
34	`no_alcanzado`
ninguno de los cuatro	`consumidor_final`

condition no viene en dos casos: cuando las inscripciones se contradicen, por ejemplo dos de la tabla activas a la vez, y cuando la constancia trae un error distinto de “no existe”. En ese último caso a la respuesta le pueden faltar inscripciones, así que su ausencia no prueba nada, y el error viene en errors. Las dos veces el SDK no adivina, y la decisión queda en tu aplicación: pedísela al cliente o revisá taxes y raw.

Buscar el CUIT por documento

Si tenés el DNI y no el CUIT, getTaxIdByDocument() devuelve los CUIT asociados a ese número:

const encontrado = await arca.padron.getTaxIdByDocument("12345678");

if (encontrado?.taxIds.length === 1) {
  const contribuyente = await arca.padron.getTaxpayerDetails(encontrado.taxIds[0]);
}

taxIds puede traer más de uno, porque un mismo número de documento puede estar asociado a más de una persona, o venir vacío. Elegí con tu cliente antes de facturar. Devuelve null cuando ARCA no encuentra el documento.

Cada consulta va a ARCA

El SDK no guarda las respuestas del Padrón. Si consultás al mismo contribuyente en cada venta, cacheá el resultado en tu aplicación con el vencimiento que te parezca razonable. Lo que sí reutiliza es el ticket WSAA de cada servicio, igual que en la emisión, como explica Configuración. Las firmas completas están en Módulos de transporte.

Empezar

Guías

Referencia

Consultar contribuyentes

Habilitar los servicios

Datos del contribuyente

Cómo se decide `condition`

Buscar el CUIT por documento

Cada consulta va a ARCA

​Habilitar los servicios

​Datos del contribuyente

​Cómo se decide condition

​Buscar el CUIT por documento

​Cada consulta va a ARCA

Habilitar los servicios

Datos del contribuyente

Cómo se decide `condition`

Buscar el CUIT por documento

Cada consulta va a ARCA