Set-Api

Documentación

Delegación ARCA

Guía operativa · Producción

Delegación de Web Services ARCA

Manual paso a paso para que un cliente autorice a Set-Api a operar un Web Service de ARCA en su nombre. Incluye lo que hace el cliente (Parte A) y lo que hace Set-Api (Parte B).

Última revisión: 27 de agosto de 2026

Ejemplo

Todos los CUIT, razones sociales y nombres de esta página son de ejemplo

Importante antes de empezar

  • 01La delegación se usa en producción. En homologación no se delega desde el Administrador de Relaciones: se crea una autorización en WSASS para el alias, CUIT representado y servicio.
  • 02Una habilitación productiva tiene este orden (punto de venta primero): PV Web Services → delegación del cliente → aceptación Set-Api → asignación al Computador Fiscal.
  • 03Sin PV tipo RECE / Web Services la API no puede emitir aunque la delegación esté perfecta. Por eso el cliente completa el PV antes de la relación.
  • 04Si falta cualquiera de las etapas de delegación (aceptar o asignar computador), ARCA puede responder: “Computador no autorizado a acceder al servicio”.
  • 05Cada servicio se delega individualmente. Delegar Facturación Electrónica no habilita WSFEX, WSCDC, Carta de Porte ni otros servicios.

Orden obligatorio de una habilitación productiva

  1. 01Cliente adhiere Puntos de venta (si no ve la empresa) y da de alta el PV Web Services.
  2. 02Cliente delega el servicio al CUIT de Set-Api.
  3. 03Set-Api acepta la designación.
  4. 04Set-Api asigna el servicio al Computador Fiscal / certificado.
  5. 05Set-Api configura el CUIT y los servicios en la organización / API Key y verifica con una consulta sin efectos.

Datos que deben intercambiarse

Set-Api informa al cliente los datos del representante. El cliente informa los datos del representado, el PV y las constancias. En operación real usá tus datos; acá solo hay ejemplos.

Set-Api informa al cliente

  • Razón social del proveedor.
  • CUIT de Set-Api / proveedor (representante).
  • Nombre exacto de cada Web Service solicitado.
  • Ambiente: producción.
  • Fecha y responsable de la solicitud.

El cliente informa a Set-Api

  • Razón social.
  • CUIT representado (empresa emisora).
  • Número de punto de venta Web Services (obligatorio, ej. 00001 / 00002).
  • Constancia del PV (sistema RECE / Web Services).
  • Servicios delegados.
  • Nombre y contacto del Administrador de Relaciones.
  • Constancia F.3283/E de cada delegación.

Plantilla de ejemplo

CUIT representado (cliente): 30-71234567-8
Razón social: Acme Ejemplo S.A.
Punto de venta Web Services (número) — OBLIGATORIO: 00001
En API se usa ptoVta: 1
CUIT representante (Set-Api): 30-70987654-3
Razón social proveedor: Set Api Demo S.A.
Servicios:
  - Facturación Electrónica (wsfe)
  - Consulta a Padrón Alcance 13
  - Consulta a Padrón Constancia de Inscripción
Administrador de Relaciones: Persona administradora de ejemplo
Fecha: 2026-08-27

Servicios bajo ARCA → WebServices

En el buscador de servicios la navegación es siempre: ARCA → WebServices → <nombre del servicio>. No elegir otro organismo. No se habilitan todos de una vez: una relación por cada servicio.

Si necesitan…Marcar en pantalla (aprox.)ID técnico
Emitir facturas A/B/C, NC, ND, FCEFacturación Electrónicawsfe
Facturas de exportaciónFactura Electrónica de exportaciónwsfex
Validar CAE de comprobantes recibidosConstatación de Comprobantes (WSCDCV1)wscdc
Consultar datos de un CUIT (padrón)Consulta a Padrón Alcance 13ws_sr_padron_a13
Condición IVA / impuestos / constanciaConsulta a Padrón Constancia de Inscripciónws_sr_constancia_inscripcion
Comprobantes de turismoWeb Service Turismo / Comprobantes de Turismowsct
Carta de porte electrónicaCarta de Porte Electrónica (WSCPE)wscpe
Remito electrónico cárnicoRemito Electrónico Cárnicowsremcarne

Recomendado para el uso típico de Set-Api

  1. Marcar Facturación Electrónica (wsfe) → confirmar esa relación.
  2. Volver a Nueva Relación y marcar Consulta a Padrón Alcance 13.
  3. Volver a Nueva Relación y marcar Consulta a Padrón Constancia de Inscripción.
  4. Agregar los demás solo si el cliente los usa (exportación, constatación, turismo, CPE, remito).
  • Padrón A13 y Constancia están en el mismo aplicativo ARCA / WebServices que Facturación Electrónica; no buscarlos en otro organismo.
  • No elegir el antiguo Alcance 5 (ws_sr_padron_a5): está deprecado.
  • Los rótulos de la UI pueden variar; confirmar por la descripción o el ID técnico.
  • Si no aparece bajo ARCA → WebServices, revisar filtros o permisos de Administrador de Relaciones.

Parte A — Lo que debe hacer el cliente

Esta parte la realiza el Administrador o Subadministrador de Relaciones del CUIT que será representado. Orden obligatorio: primero el punto de venta, después la relación (delegación). No empezar por Nueva Relación si todavía no hay PV Web Services.

01

Paso 1 — Ingresar a ARCA

Opciones oficiales para obtener o elevar la clave: App ARCA Móvil (Herramientas → Solicitud y/o recupero de clave fiscal), homebanking del banco, o turno presencial con DNI y Formulario 206. Guía oficial de ARCA: Obtener la Clave Fiscal.

  1. Abrir https://www.arca.gob.ar/.
  2. Presionar Iniciar sesión.
  3. Ingresar CUIT/CUIL/CDI personal y Clave Fiscal.
  4. Verificar que la cuenta tenga Clave Fiscal nivel 3 (o superior). Es el nivel mínimo para administrar relaciones, delegar Web Services y operar puntos de venta.

Atención

Sin nivel 3 no podrá completar el PV ni la delegación. Si tiene nivel 1 o 2, elevarlo antes de seguir.

02

Paso 2 — Adherir Puntos de venta (si la empresa no aparece)

Si al abrir Gestión de puntos de venta el CUIT de la empresa no figura en “Seleccione la Empresa a representar”, primero hay que adherir el servicio.

  1. Abrir Administrador de Relaciones de Clave Fiscal.
  2. Elegir como representado el CUIT de la empresa emisora (no la persona física).
  3. Adherir Servicio.
  4. Buscar Administración de puntos de venta y domicilios (o “PVE - Gestión de puntos de venta”).
  5. Adherirlo para la empresa emisora.
  6. Volver a Mis Servicios → abrir de nuevo Puntos de venta.

Delegar Web Services no habilita PVE. Son permisos distintos. Si el selector solo muestra la persona física u otra SA, no continuar con Factura en Línea de otra empresa.

03

Paso 3 — Alta del punto de venta Web Services

Obligatorio antes de la relación. Sin este PV, Set-Api no puede obtener CAE.

Confirmar, descargar la constancia y anotar el número de PV. Enviar a Set-Api el número exacto (ej. 00001 → en API se usa ptoVta: 1).

El número de PV es obligatorio. Sin ese dato no se puede configurar ni emitir. “Tengo un PV” no alcanza: hay que pasar el número concreto.

  1. Mis Servicios → Administración de puntos de venta y domicilios.
  2. Seleccione la Empresa a representar → CUIT de la empresa emisora.
  3. A/B/M de puntos de venta → Agregar.
CampoValor
NúmeroEl que asigne ARCA (ej. 00001) — obligatorio informar a Set-Api
DomicilioDomicilio fiscal/comercial de la empresa en ARCA
ActividadActividad principal con la que facturan
SistemaRECE para aplicativo y Web Services (RI). Si es Monotributo: Factura Electrónica - Monotributo - Web Services.

Correcto en la constancia: Sistema “RECE para aplicativo y web services”. Incorrecto para la API (hay que modificar o crear otro PV): “Factura en Línea - Responsable Inscripto”.

Atención

Si en Sistema solo aparece Remito u otras opciones: revisar domicilio y actividad de la empresa, guardar y reabrir el formulario.

04

Paso 4 — Abrir Administrador de Relaciones (para delegar)

Recién ahora se inicia la relación / delegación.

  1. Buscar Administrador de Relaciones de Clave Fiscal.
  2. Abrir el servicio.
  3. En el selector de representados, elegir la empresa/cliente correcto.

Atención

No elegir por error a la persona física administradora. La pantalla debe mostrar el CUIT de la empresa que delegará el Web Service.

05

Paso 5 — Iniciar una nueva relación

  1. Seleccionar Nueva Relación.
  2. Revisar que el Representado sea el CUIT del cliente.
  3. En Servicio, presionar Buscar.
06

Paso 6 — Elegir el servicio

Navegación: ARCA → WebServices → <nombre del servicio>. Abrir el ícono / agrupación ARCA (ex AFIP). Marcar solo el servicio que desean habilitar en esa relación.

Ver la tabla de servicios más arriba. Uso típico del gateway Set-Api: wsfe + padrón A13 + constancia de inscripción.

07

Paso 7 — Designar a Set-Api

  1. En Representante, presionar Buscar.
  2. Elegir la opción para ingresar CUIT/CUIL/CDI.
  3. Escribir el CUIT de Set-Api/proveedor, sin guiones (ejemplo de documentación: 30709876543).
  4. Presionar Buscar.
  5. Verificar que ARCA muestre la razón social correcta.
  6. Seleccionar ese representante.

Atención

No elegir un Computador Fiscal del cliente: se está tercerizando el servicio y el representante debe ser el CUIT de Set-Api.

08

Paso 8 — Confirmar

Antes de confirmar, revisar:

  1. Representado: CUIT del cliente.
  2. Servicio: Web Service solicitado.
  3. Representante: CUIT de Set-Api.
  4. Presionar Confirmar (y confirmar nuevamente si ARCA presenta revisión).
  5. Descargar o imprimir la constancia F.3283/E.
  6. Enviar la constancia a Set-Api, junto con el número de PV del Paso 3.
09

Paso 9 — Repetir por cada servicio

Volver a Nueva Relación y repetir los pasos 5 a 8 para cada WSN que quieran habilitar. ARCA genera una relación y constancia separada por servicio.

Ejemplo: si el cliente pide facturar y consultar CUIT, deben quedar al menos tres relaciones: Facturación Electrónica, Padrón Alcance 13 y Constancia de Inscripción.

Parte B — Lo que debe hacer Set-Api

Esta parte la realiza el Administrador de Relaciones del CUIT que recibió la delegación. Aceptar la designación todavía no habilita el backend: falta asignarla a un Computador Fiscal y configurar la cuenta del cliente.

10

Paso 10 — Aceptar la designación

  1. Ingresar a ARCA con Clave Fiscal.
  2. Abrir Administrador de Relaciones de Clave Fiscal.
  3. Seleccionar el CUIT de Set-Api como representado.
  4. Abrir Aceptación de Designación / Designaciones pendientes (según la interfaz vigente).
  5. Buscar la relación enviada por el CUIT cliente.
  6. Verificar CUIT del cliente, servicio delegado y fecha de designación.
  7. Presionar Aceptar, guardar la constancia y repetir para todos los servicios.

Atención

Aceptar la designación todavía no habilita el backend. Falta asignarla a un Computador Fiscal.

11

Paso 11 — Elegir el cliente como representado

  1. Volver al menú principal del Administrador de Relaciones.
  2. Seleccionar Nueva Relación.
  3. En Representado, elegir el CUIT del cliente.

Después de aceptar, el CUIT del cliente debe aparecer entre los representados. Si no aparece: cerrar sesión y volver a entrar, verificar que la designación fue aceptada, confirmar que el cliente delegó al CUIT correcto de Set-Api.

12

Paso 12 — Seleccionar el servicio delegado

  1. Presionar Buscar en Servicio.
  2. La lista debe mostrar únicamente los servicios que el cliente autorizó a Set-Api.
  3. Seleccionar el servicio correspondiente.

Si el servicio no aparece: el cliente delegó otro servicio, la designación sigue pendiente, se eligió otro CUIT representado, o la relación fue revocada.

13

Paso 13 — Asignar el Computador Fiscal

  1. En Representante, presionar Buscar.
  2. Seleccionar el Computador Fiscal asociado al certificado productivo que usa el gateway.
  3. No ingresar otro CUIT: una subdelegación no puede continuar hacia una tercera empresa.
  4. Confirmar el alias/nombre del computador (ejemplo: set-api-prod-01).
14

Paso 14 — Confirmar la subdelegación

Revisar:

  1. Representado: CUIT del cliente.
  2. Servicio: WSN delegado.
  3. Representante: computador/certificado Set-Api.
  4. Presionar Confirmar (y la pantalla final).
  5. Descargar la constancia F.3283/E.
  6. Repetir por cada servicio y cliente.
15

Paso 15 — Configurar el cliente en Set-Api

Se asocia el CUIT y los servicios autorizados a la organización / API Key del cliente en el panel Set-Api (grants de CUIT y scopes).

Luego se valida con una consulta sin efectos (por ejemplo puntos de venta o padrón) antes de emitir comprobantes.

Checklist del cliente

  1. Entró como administrador del CUIT correcto
  2. Adhirió Puntos de venta para la empresa (si no aparecía en el selector)
  3. Dio de alta PV con RECE para aplicativo y Web Services
  4. Envió a Set-Api el número de PV (ej. 00001 / 00002) — obligatorio
  5. Seleccionó al cliente como representado
  6. Marcó el servicio correcto en ARCA → WebServices
  7. Ingresó el CUIT correcto de Set-Api
  8. Confirmó la relación
  9. Guardó F.3283/E
  10. Repitió el circuito para cada servicio a habilitar
  11. Avisó a Set-Api que las designaciones están pendientes de aceptación

Checklist de Set-Api

  1. Recibió número de PV Web Services y constancia del cliente
  2. Aceptó cada designación
  3. El cliente aparece como representado
  4. Seleccionó el mismo servicio delegado
  5. Asignó el Computador Fiscal productivo correcto
  6. Guardó cada F.3283/E
  7. Configuró CUIT/servicios en la cuenta / API Key
  8. Probó puntos de venta u otra operación sin efectos

Parte D — Verificar la delegación

La delegación está técnicamente correcta cuando:

  • WSAA entrega un TA para el servicio.
  • La respuesta no contiene “Computador no autorizado”.
  • El WSN responde datos o un error funcional de negocio.

Un error funcional de punto de venta, actividad o datos no significa necesariamente que la delegación esté mal: indica que la autenticación fue superada y falta resolver una condición del servicio.

Solución de problemas

La designación no aparece en Set-Api+
  • Verificar el CUIT representante usado por el cliente.
  • Confirmar que el cliente presionó Confirmar.
  • Solicitar la constancia F.3283/E.
  • Cerrar sesión y volver a ingresar.
  • Revisar Designaciones pendientes.
El cliente no aparece como representado+
  • Confirmar que Set-Api aceptó la designación.
  • Verificar que se ingresó con el Administrador del CUIT Set-Api correcto.
  • Cerrar sesión y reingresar.
El servicio no aparece al crear la subdelegación+
  • Seleccionar al cliente como representado.
  • Confirmar que el cliente delegó exactamente ese WSN.
  • Revisar que la relación no esté revocada.
“Computador no autorizado a acceder al servicio”+
  • Certificado de producción contra endpoints de producción.
  • service / wsid correcto.
  • Cliente delegó el WSN a Set-Api.
  • Set-Api aceptó la designación.
  • Set-Api asignó ese WSN y cliente al computador correcto.
  • El backend firma con el certificado de ese computador.
  • El CUIT enviado es el CUIT representado delegado.
La delegación está bien pero ARCA rechaza+
  • Revisar requisitos de negocio: punto de venta/emisión, régimen y actividad, domicilios, roles registrales, numeración y datos obligatorios.

Revocar una delegación

Cliente

  1. Ingresar a Administrador de Relaciones.
  2. Seleccionar al cliente como representado.
  3. Abrir Consultar → buscar a Set-Api entre los representantes.
  4. Abrir el detalle de relaciones → Revocar junto al servicio → Confirmar.
  5. Guardar la constancia y repetir por cada servicio.

Set-Api

  1. Retirar el CUIT/servicio de la organización / API Key.
  2. Revocar o eliminar la subdelegación al computador si aún figura.
  3. Limpiar el TA del servicio.
  4. Rotar la API Key del cliente si finalizó la relación.

Solicitud modelo para enviar al cliente

Asunto: Delegación de Web Service ARCA a Set-Api

Solicitamos delegar desde el Administrador de Relaciones de Clave Fiscal:

Representado: Acme Ejemplo S.A. — CUIT 30-71234567-8
Representante: Set Api Demo S.A. — CUIT 30-70987654-3

Servicios:
- Facturación Electrónica
- Consulta a Padrón Alcance 13
- Consulta a Padrón Constancia de Inscripción

Por cada servicio:
1. Ingresar como Administrador de Relaciones del cliente.
2. Nueva Relación.
3. Buscar el servicio dentro de Web Services.
4. Seleccionar como representante el CUIT de Set-Api.
5. Confirmar.
6. Enviar la constancia F.3283/E y el número de PV Web Services.

La delegación debe realizarse una vez por cada servicio.

← Volver a docs·Quickstart