ARCA Reference Constants Exported by facturas

The facturas/constants sub-path exports a small, stable set of ARCA reference codes as typed TypeScript constants. Use them anywhere you need to reference a voucher type, VAT rate, document type, or currency without hardcoding numeric or string literals in your application code.

import {
  ARCA_CONCEPT_TYPES,
  ARCA_CURRENCY_IDS,
  ARCA_CURRENCIES,
  ARCA_DOCUMENT_TYPES,
  ARCA_RECEIVER_VAT_CONDITIONS,
  ARCA_VAT_RATES,
  ARCA_VOUCHER_TYPES,
  ISO_CURRENCIES,
} from "facturas/constants";

These constants match the static ARCA reference data documented in the official catalogs. For authoritative, up-to-date lists at runtime — especially useful if ARCA adds or changes codes — use the live catalog methods on arca.wsfe: getVoucherTypes(), getDocumentTypes(), getCurrencyTypes(), and getVatRates().

`ARCA_VOUCHER_TYPES`

Voucher type codes used in voucherType fields across the WSFE and WSMTXCA APIs.

Key	Value	Description
`FACTURA_A`	`1`	Factura A
`NOTA_DEBITO_A`	`2`	Nota de Débito A
`NOTA_CREDITO_A`	`3`	Nota de Crédito A
`FACTURA_B`	`6`	Factura B
`NOTA_DEBITO_B`	`7`	Nota de Débito B
`NOTA_CREDITO_B`	`8`	Nota de Crédito B
`FACTURA_C`	`11`	Factura C
`NOTA_DEBITO_C`	`12`	Nota de Débito C
`NOTA_CREDITO_C`	`13`	Nota de Crédito C

import { ARCA_VOUCHER_TYPES } from "facturas/constants";

ARCA_VOUCHER_TYPES.FACTURA_A; // 1
ARCA_VOUCHER_TYPES.FACTURA_B; // 6
ARCA_VOUCHER_TYPES.FACTURA_C; // 11
ARCA_VOUCHER_TYPES.NOTA_CREDITO_A; // 3

`ARCA_DOCUMENT_TYPES`

Document type codes used in documentType fields to identify the receiver.

Key	Value	Description
`CUIT`	`80`	CUIT (tax ID)
`DNI`	`96`	DNI (national identity document)
`CONSUMIDOR_FINAL`	`99`	Consumidor Final (anonymous retail customer)

import { ARCA_DOCUMENT_TYPES } from "facturas/constants";

ARCA_DOCUMENT_TYPES.CUIT;             // 80
ARCA_DOCUMENT_TYPES.DNI;              // 96
ARCA_DOCUMENT_TYPES.CONSUMIDOR_FINAL; // 99

For Factura B to consumidor final, use documentType: ARCA_DOCUMENT_TYPES.CONSUMIDOR_FINAL together with documentNumber: 0. ARCA enforces rules on which document types are valid for a given voucher class and total amount — see WSFE error 10015 in the error handling guide if you hit a validation rejection.

`ARCA_RECEIVER_VAT_CONDITIONS`

Receiver VAT condition codes (condición de IVA del receptor) used in receiverVatConditionId fields. The high-level issue() facade accepts receiverVatCondition as a human-readable string (e.g., "consumidor_final"); these numeric codes are used in exact-layer WsfeVoucherInput and WSMTXCA requests.

Key	Value	Description
`RESPONSABLE_INSCRIPTO`	`1`	Registered VAT taxpayer
`EXENTO`	`4`	VAT-exempt taxpayer
`CONSUMIDOR_FINAL`	`5`	Final consumer
`MONOTRIBUTISTA`	`6`	Monotributo taxpayer
`IVA_NO_ALCANZADO`	`15`	Not subject to VAT

import { ARCA_RECEIVER_VAT_CONDITIONS } from "facturas/constants";

ARCA_RECEIVER_VAT_CONDITIONS.RESPONSABLE_INSCRIPTO; // 1
ARCA_RECEIVER_VAT_CONDITIONS.EXENTO;                // 4
ARCA_RECEIVER_VAT_CONDITIONS.CONSUMIDOR_FINAL;      // 5
ARCA_RECEIVER_VAT_CONDITIONS.MONOTRIBUTISTA;        // 6
ARCA_RECEIVER_VAT_CONDITIONS.IVA_NO_ALCANZADO;      // 15

The facade’s receiverVatCondition accepts human-readable strings: "responsable_inscripto", "monotributo", "exento", "no_alcanzado", or "consumidor_final". Use the numeric constants from ARCA_RECEIVER_VAT_CONDITIONS only when constructing a WsfeVoucherInput directly in the exact layer.

`ARCA_CONCEPT_TYPES`

Concept type codes (tipos de concepto) used in concept fields.

Key	Value	Description
`PRODUCTOS`	`1`	Products only
`SERVICIOS`	`2`	Services only
`PRODUCTOS_Y_SERVICIOS`	`3`	Products and services

import { ARCA_CONCEPT_TYPES } from "facturas/constants";

ARCA_CONCEPT_TYPES.PRODUCTOS;              // 1
ARCA_CONCEPT_TYPES.SERVICIOS;              // 2
ARCA_CONCEPT_TYPES.PRODUCTOS_Y_SERVICIOS;  // 3

`ARCA_VAT_RATES`

VAT rate codes used in id fields inside vatRates arrays. Note that these are ARCA’s internal numeric identifiers for each rate — they are not the percentage values themselves.

Key	ARCA Code	Actual Rate
`IVA_0`	`3`	0 %
`IVA_2_5`	`9`	2.5 %
`IVA_5`	`8`	5 %
`IVA_10_5`	`4`	10.5 %
`IVA_21`	`5`	21 %
`IVA_27`	`6`	27 %

import { ARCA_VOUCHER_TYPES, ARCA_VAT_RATES } from "facturas/constants";

console.log(ARCA_VOUCHER_TYPES.FACTURA_B); // 6
console.log(ARCA_VAT_RATES.IVA_21);        // 5 (ARCA's internal code for 21%)

ARCA_VAT_RATES.IVA_21 is 5, not 21. Always use the constant keys rather than numeric literals to avoid this common confusion.

`ARCA_CURRENCY_IDS`

Maps human-readable currency names to ARCA’s internal currency identifiers. Use these in currencyId fields when constructing a WsfeVoucherInput directly.

Key	ARCA ID	Currency
`ARS`	`"PES"`	Argentine Peso
`USD`	`"DOL"`	US Dollar

import { ARCA_CURRENCY_IDS } from "facturas/constants";

ARCA_CURRENCY_IDS.ARS; // "PES"
ARCA_CURRENCY_IDS.USD; // "DOL"

ARCA does not use ISO 4217 codes for currencies in its protocol. "PES" is the ARCA ID for ARS and "DOL" is the ARCA ID for USD. The high-level builders (buildFacturaB, buildFacturaC) accept ISO codes ("ARS", "USD") and translate them internally — you only need ARCA_CURRENCY_IDS when working at the exact layer.

`ISO_CURRENCIES`

ISO 4217 currency codes used by the high-level builders.

Key	Value
`ARS`	`"ARS"`
`USD`	`"USD"`

import { ISO_CURRENCIES } from "facturas/constants";

ISO_CURRENCIES.ARS; // "ARS"
ISO_CURRENCIES.USD; // "USD"

`ARCA_CURRENCIES` (deprecated)

A compatibility alias that maps directly to ARCA protocol IDs ("PES", "DOL"). This export is deprecated — use ARCA_CURRENCY_IDS instead.

import { ARCA_CURRENCIES } from "facturas/constants";

// Deprecated — prefer ARCA_CURRENCY_IDS
ARCA_CURRENCIES.PES; // "PES"
ARCA_CURRENCIES.DOL; // "DOL"

Runtime Catalogs

The constants above cover the most common codes used throughout the SDK documentation and examples. When you need the full, authoritative list from ARCA at runtime, call the catalog methods on the wsfe service:

import { createArcaClient } from "facturas";
const arca = createArcaClient({ taxId: "20123456786", certificatePem: "", privateKeyPem: "", environment: "test" });
// ---cut---
const voucherTypes   = await arca.wsfe.getVoucherTypes();
const documentTypes  = await arca.wsfe.getDocumentTypes();
const currencyTypes  = await arca.wsfe.getCurrencyTypes(); // returns ARCA IDs, not ISO codes
const vatRates       = await arca.wsfe.getVatRates();

getCurrencyTypes() returns ARCA protocol identifiers like "PES" and "DOL", not ISO 4217 codes. Keep this in mind if you display these values to end users.

Get Started

Core Concepts

Guides

CLI

Reference

ARCA Reference Constants Exported by facturas

`ARCA_VOUCHER_TYPES`

`ARCA_DOCUMENT_TYPES`

`ARCA_RECEIVER_VAT_CONDITIONS`

`ARCA_CONCEPT_TYPES`

`ARCA_VAT_RATES`

`ARCA_CURRENCY_IDS`

`ISO_CURRENCIES`

`ARCA_CURRENCIES` (deprecated)

Runtime Catalogs

​ARCA_VOUCHER_TYPES

​ARCA_DOCUMENT_TYPES

​ARCA_RECEIVER_VAT_CONDITIONS

​ARCA_CONCEPT_TYPES

​ARCA_VAT_RATES

​ARCA_CURRENCY_IDS

​ISO_CURRENCIES

​ARCA_CURRENCIES (deprecated)

​Runtime Catalogs

`ARCA_VOUCHER_TYPES`

`ARCA_DOCUMENT_TYPES`

`ARCA_RECEIVER_VAT_CONDITIONS`

`ARCA_CONCEPT_TYPES`

`ARCA_VAT_RATES`

`ARCA_CURRENCY_IDS`

`ISO_CURRENCIES`

`ARCA_CURRENCIES` (deprecated)

Runtime Catalogs