Comprobante por URL

Guías

Cómo armar el link para los casos de todos los días, como identificar al receptor, facturar productos o un período pasado, elegir la unidad de medida y el CUIT que lo emite.

Cada guía resuelve un caso concreto. Los parámetros completos están en la referencia.

Identificar al receptor

Sin customer, la factura sale a un Consumidor Final sin identificar. Para identificar al receptor, pasá su condición frente al IVA y su documento:

import {
  CustomerDocumentType,
  CustomerTaxCondition,
  Factumono,
  VoucherType,
} from "@factumono/sdk";

const url = Factumono.createVoucherUrl({
  type: VoucherType.FacturaC,
  items: [{ description: "Diseño de logo", unitPrice: 350000 }],
  customer: {
    taxCondition: CustomerTaxCondition.ResponsableInscripto,
    documentType: CustomerDocumentType.CUIT,
    documentNumber: "30-00000000-7", // con o sin guiones y puntos
    name: "Tostadero del Sur S.A.",
    address: "Av. Siempreviva 742",
  },
});

Qué documento pide cada receptor:

Receptor (taxCondition)documentType
ConsumidorFinal (es el valor por defecto)Ninguno. DNI, CUIT o CUIL si lo conocés.
ConsumidorFinal desde $10.000.000DNI, CUIT o CUIL: es obligatorio.
Monotributo y sus variantesCUIT
Cualquier otro (ResponsableInscripto, etc.)CUIT o CUIL
  • Si pasás documentNumber sin documentType, el SDK lo toma como CUIT.
  • Si no lo identificás, no mandes documentNumber: CustomerDocumentType.None no admite número.
  • name (la Razón Social) y address (el domicilio) son opcionales y se imprimen en la factura.

El SDK no verifica que el CUIT del receptor exista ni que su dígito verificador sea correcto (solo lo hace para un Consumidor Final desde $10.000.000). Un CUIT mal escrito arma el link igual y el error aparece recién al emitir. Si tu sistema carga CUITs, validalos antes de armar el link.

Este es el mismo chequeo de formato que hace Factumono con el CUIT del emisor: 11 dígitos, un prefijo válido y el dígito verificador.

function esCuitValido(cuit: string): boolean {
  const digitos = cuit.replace(/\D/g, "");
  if (!/^(20|23|24|25|26|27|30|33|34)\d{9}$/.test(digitos)) return false;

  const pesos = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2];
  const suma = pesos.reduce(
    (total, peso, i) => total + peso * Number(digitos[i]),
    0,
  );
  const resto = 11 - (suma % 11);

  if (resto === 10) return false;
  return (resto === 11 ? 0 : resto) === Number(digitos[10]);
}

Productos, servicios y fechas

concept dice qué se factura y cambia qué fechas hacen falta:

conceptFechas que lleva la factura
Servicios (por defecto)Emisión, período facturado (periodFrom–periodTo) y vencimiento del pago (paymentDueAt)
ProductosYServiciosIgual que Servicios
ProductosSolo la emisión: no hace falta período ni vencimiento

Si no pasás fechas, la factura es de hoy, el período es el mes de la fecha de emisión y el vencimiento es la fecha de emisión. Todas las fechas son días de Argentina escritos como texto "AAAA-MM-DD". Un Date o un timestamp da error, porque el día que representa depende de la zona horaria.

Una venta de productos de hace unos días:

import {
  Concept,
  Factumono,
  SalesCondition,
  VoucherType,
} from "@factumono/sdk";

const url = Factumono.createVoucherUrl({
  type: VoucherType.FacturaC,
  concept: Concept.Productos,
  issuedAt: "2026-10-30", // la fecha de la venta
  items: [
    {
      description: "Café en grano",
      quantity: 3,
      unitPrice: 18000,
      unitMeasureId: 1, // kilogramos
    },
    { description: "Filtros de papel", quantity: 2, unitPrice: 4500 },
  ],
  salesCondition: SalesCondition.Contado,
});

Un servicio de octubre, facturado el 2 de noviembre y que se paga a 15 días:

import { Factumono, SalesCondition, VoucherType } from "@factumono/sdk";

const url = Factumono.createVoucherUrl({
  type: VoucherType.FacturaC,
  items: [{ description: "Consultoría", quantity: 8, unitPrice: 40000 }],
  issuedAt: "2026-11-02",
  periodFrom: "2026-10-01", // el período facturado: todo octubre
  periodTo: "2026-10-31",
  paymentDueAt: "2026-11-17", // 15 días después de issuedAt
  salesCondition: SalesCondition.CuentaCorriente,
});

Para calcular estas fechas en tu sistema, tomá el día de hoy en Argentina, no el de tu servidor:

// Hoy en Argentina, como "AAAA-MM-DD", corra donde corra tu código.
const hoy = new Intl.DateTimeFormat("en-CA", {
  timeZone: "America/Argentina/Buenos_Aires",
}).format(new Date());

// Un día "AAAA-MM-DD" más (o menos) n días.
function sumarDias(dia: string, dias: number): string {
  const fecha = new Date(`${dia}T12:00:00Z`);
  fecha.setUTCDate(fecha.getUTCDate() + dias);
  return fecha.toISOString().slice(0, 10);
}

const vencimiento = sumarDias(hoy, 15);

Qué fechas acepta ARCA, contando desde el día en que se abre el link:

FechaLímite
issuedAtHasta 10 días antes o después de hoy.
issuedAt con Concept.ProductosHasta 5 días antes o después de hoy, y nunca en un mes posterior al actual.
periodToNo puede ser anterior a periodFrom.
paymentDueAtNo puede ser anterior a issuedAt.

Los límites se cuentan por hora, no por día: una fecha justo en el borde (a 10 o a 5 días) puede fallar según la hora en que se abre el link. Dejá un día de margen.

El SDK valida las fechas el día que arma la URL, y Factumono las vuelve a validar el día que tu cliente abre el link. Por eso:

  • Un link sin fechas no vence: Factumono usa la fecha del día en que se abre, y el período es el mes de ese día. Lo podés generar una vez y guardarlo, pero si se abre en diciembre, factura diciembre.
  • Un link con fechas vence cuando esas fechas quedan fuera de los límites. No lo guardes en tu base para mostrarlo días después: generalo cuando tu cliente va a facturar.

La forma más simple de generarlo en el momento es que el botón apunte a tu servidor, y que tu servidor arme el link y redirija. Si la venta ya quedó fuera de los límites, el SDK no arma el link: respondé con un mensaje que tu cliente entienda en vez de un error.

import { Factumono, ValidationError, VoucherType } from "@factumono/sdk";

// GET /ventas/facturar?id=123: el botón "Facturar" de tu sistema apunta acá.
export async function GET(request: Request): Promise<Response> {
  const venta = await buscarVenta(new URL(request.url).searchParams.get("id"));

  try {
    const url = Factumono.createVoucherUrl({
      type: VoucherType.FacturaC,
      issuedAt: venta.fecha,
      items: venta.lineas.map((linea) => ({
        description: linea.nombre,
        quantity: linea.cantidad,
        unitPrice: linea.precio,
      })),
    });

    return Response.redirect(url, 302);
  } catch (error) {
    if (!(error instanceof ValidationError)) throw error;

    // Por ejemplo, issuedAtMax10DaysPast: la venta es de hace más de 10 días.
    const vencida = error.errors.some(({ path }) => path === "issuedAt");

    return new Response(
      vencida
        ? "Esta venta ya no se puede facturar con su fecha: ARCA no la acepta."
        : "No pudimos armar la factura. Revisá los datos de la venta.",
      { status: 422 },
    );
  }
}

Líneas, cantidades y unidades de medida

  • Cada línea es unitPrice × quantity. Dos unidades a $50.000 son $100.000.
  • quantity acepta decimales: media hora (0.5), 2,5 kilos (2.5).
  • unitPrice puede ser 0 (una línea sin cargo), nunca negativo.
  • Un link lleva hasta 50 líneas, y cada description, hasta 4000 caracteres.

unitMeasureId es el código de la unidad de medida de ARCA. Si no lo pasás, es 7 (unidades). El SDK exporta las más usadas en COMMON_MEASURE_UNITS:

unitMeasureIdUnidad
7unidades
98otras unidades
1kilogramos
14gramos
5litros
2metros
3metros cuadrados
4metros cúbicos
9docenas
8pares
96packs
29toneladas

ARCA no tiene una unidad para horas: una hora de trabajo o una sesión se facturan como 7 (unidades). Un paquete que vendés entero también es una unidad; 96 (packs) es para cuando la línea cuenta packs de varias unidades. Los códigos 0, 95, 97 y 99 están reservados por ARCA y dan error.

Forma de pago

salesCondition se imprime en la factura; ARCA no la recibe. Si no la pasás, dice "Otra".

SalesConditionCuándo usarla
ContadoEfectivo o pago en el momento.
TarjetaDeDebitoTarjeta de débito.
TarjetaDeCreditoTarjeta de crédito.
TransferenciaBancariaTransferencia bancaria.
CuentaCorrienteSe paga más adelante. Combinala con paymentDueAt.
OtraCualquier otro caso.

Abrir el comprobante en un CUIT

taxId es el CUIT del emisor: en qué CUIT de Factumono se abre el comprobante.

import { Factumono, VoucherType } from "@factumono/sdk";

const url = Factumono.createVoucherUrl({
  type: VoucherType.FacturaC,
  taxId: "20-00000000-1", // con o sin guiones
  items: [
    { description: "Sesión de kinesiología", quantity: 2, unitPrice: 25000 },
  ],
});
  • Sin taxId, el comprobante se abre en el último CUIT que tu cliente usó en Factumono desde ese navegador. Alcanza si tu cliente tiene un solo CUIT.
  • Con taxId, el SDK verifica que sea un CUIT válido (11 dígitos y dígito verificador) y Factumono abre ese CUIT.
  • Si la persona no tiene ese CUIT, Factumono no avisa: abre el CUIT que esté usando, con los datos cargados. Si tus clientes manejan más de un CUIT, pasalo siempre y asegurate de mandar a cada uno el link de su CUIT.

Elegir el punto de venta

Sin salesPointId, Factumono usa el 400, el punto de venta que crea al dar de alta la facturación, con el domicilio fiscal del CUIT. Si tu cliente tiene otros locales cargados en ARCA, Factumono crea uno más por cada domicilio: 401, 402 y así. Pasalo solo para facturar desde uno de esos locales.

Tiene que ser un punto de venta que creó Factumono, del 400 al 499. El que tu cliente usa en ARCA para Comprobantes en línea no sirve: el formulario no lo muestra, y ARCA rechaza el comprobante al emitirlo. El SDK no sabe qué puntos de venta tiene cada CUIT, así que un número que no corresponde arma el link igual y el error aparece recién al emitir.

import { Factumono, VoucherType } from "@factumono/sdk";

const url = Factumono.createVoucherUrl({
  type: VoucherType.FacturaC,
  salesPointId: 401, // el segundo local de tu cliente
  items: [{ description: "Corte de pelo", unitPrice: 15000 }],
});
Logo de WhatsApp