Puntos de venta

Un punto de venta es la numeración bajo la cual emitís ejemplo 00001. Cada uno lleva su propia secuencia correlativa por tipo de comprobante, y es el valor que mandás como posNumber al emitir con API.

Tiene que existir de los dos lados: dado de alta en ARCA y configurado en NanoFactura.

Paso 1 — Dalo de alta en ARCA

En el portal de ARCA, con tu Clave Fiscal:

1. Entrá a Administración de Puntos de Venta y Domicilios.
2. Agregar punto de venta.
3. Elegí el sistema Factura Electrónica ó Servicio Web (RECE).

El tipo de punto de venta importa

Un punto de venta creado para Comprobantes en Línea (el portal web de ARCA) no sirve para facturar por API. Son numeraciones distintas y ARCA las trata por separado. Tiene que ser de servicio web.

Si vas a usar los dos canales, necesitás un punto de venta de cada tipo.

El entorno de homologación usa los mismos puntos de venta que producción.

Paso 2 — Verificá que ARCA lo tenga

GET /:id-empresa/pos/arca

Consulta a ARCA los puntos de venta efectivamente habilitados para facturación electrónica en el entorno de tu clave. Es la forma de confirmar que el número que vas a usar existe del lado de ARCA antes de intentar emitir.

Paso 3 — Configuralo en NanoFactura

Podés hacerlo desde la app (Administrar Empresa → Puntos de venta) o por API:

curl -X POST https://nanofactura.com/api/mi-empresa/pos \
  -H "Authorization: Bearer PROD_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "number": 1,
    "name": "Casa Central",
    "address": "Av. de Mayo 500, CABA",
    "email": "[email protected]",
    "legend": "Gracias por su compra"
  }'

Campo	Obligatorio	Descripción
number	Sí	El número del punto de venta, igual al de ARCA. Es el posNumber al emitir.
name	No	Nombre de fantasía. Se imprime en el comprobante.
address	No	Domicilio comercial. Se imprime en el comprobante.
email	No	Email de contacto que aparece en el comprobante.
legend	No	Leyenda fija al pie de todos los comprobantes de este punto de venta.
webOnly	No	true sólo para puntos de venta de Comprobantes en Línea. No sirven para la API.

Consultar los configurados

GET /:id-empresa/pos

{
  "ok": true,
  "result": [
    {
      "id": "-Oxf2…",
      "number": 1,
      "name": "Casa Central",
      "address": "Av. de Mayo 500, CABA",
      "email": "[email protected]",
      "webOnly": false,
      "legend": "",
      "logoURL": "https://…",
      "cuit": "20383738890",
      "inicioActividades": "2015-03-01",
      "ingresosBrutos": "20-38373889-0",
      "opConRetenciones": false,
      "condIVA": 6
    }
  ]
}

number es lo que mandás como posNumber. Los campos fiscales (cuit, inicioActividades, ingresosBrutos, condIVA) vienen de los datos de la empresa y son los que se imprimen en el encabezado del comprobante.

webOnly: true no sirve para la API

Esos puntos de venta están pensados para comprobantes cargados a mano en el portal de ARCA. Tienen number: null y no se pueden usar como posNumber. Filtralos.

Endpoints

Método	Ruta	Descripción
GET	/:id-empresa/pos	Lista los configurados
GET	/:id-empresa/pos/:posId	Devuelve uno
GET	/:id-empresa/pos/arca	Lista los habilitados en ARCA
POST	/:id-empresa/pos	Crea uno
PATCH	/:id-empresa/pos/:posId	Modifica uno
POST	/:id-empresa/pos/:posId/logo	Sube el logo
DELETE	/:id-empresa/pos/:posId	Elimina uno

Logo del comprobante

POST /:id-empresa/pos/:posId/logo

Se manda como multipart/form-data con el campo logo.

Requisito	Valor
Formatos	JPG o PNG
Peso máximo	100 KB
Tamaño recomendado	400×185 px

El logo se imprime a 400×185 y la API no redimensiona: mandalo ya ajustado a esa proporción.

Desde la app es más fácil

La aplicación web normaliza el logo sola: lo recorta a 400×185 sobre fondo blanco y lo comprime. Si no querés programar el redimensionado, subilo desde ahí una vez y listo.

Cuántos puedo tener

El tope es de 10 puntos de venta por empresa. Ver Límites.

Y ahora

Con el punto de venta configurado, seguí con la API Key.