Productos y servicios

El catálogo es uno por empresa y sirve igual en demo (sk_test_) y en producción (sk_live_). Es opcional: los ítems escritos a mano siguen funcionando como siempre.

Producto, opciones y variantes

• Producto simple o servicio: tiene una sola variante (la crea Facturalo). Su varianteId viene en la respuesta.
• Con variantes: hasta 3 opciones (por ejemplo Talla y Color) y una variante por combinación (S / Azul, M / Rojo…), cada una con su SKU, código de barras y precio.
• SKU y código de barras son únicos por empresa. Un código de barras EAN-13 que empiece con 20–29 es de uso interno: no necesitas registro GS1.

Emitir o cotizar con el catálogo

En POST /documentos/enviar y en las cotizaciones, cada ítem acepta productoId (id de la variante, o del producto si tiene una sola variante) o el SKU / código de barras en codigo. Lo que envías manda; lo que falta sale del catálogo: descripción, unidad, tipo de IGV, código SUNAT y precio (en PEN o USD según la moneda).

{
  "items": [
    {
      "productoId": "a32f4541-75eb-4b59-ad28-3c571652fe39",
      "cantidad": 2
    },
    {
      "productoId": "a32f4541-75eb-4b59-ad28-3c571652fe39",
      "cantidad": 1,
      "precioUnitario": 4300
    },
    {
      "codigo": "POLO-AZ-M",
      "cantidad": 3
    },
    {
      "descripcion": "Envío",
      "cantidad": 1,
      "precioUnitario": 15,
      "unidadMedida": "ZZ",
      "tipoIgv": "10"
    }
  ]
}

• Ítem 1: todo del catálogo. Ítem 2: otro precio para esta venta. Ítem 3: por SKU. Ítem 4: a mano, como siempre.
• Un productoId o SKU que no existe (o está inactivo) devuelve 422 antes de ir a SUNAT.
• Si el producto controla stock, la venta descuenta del inventario. Si controla número de serie, envía series con una serie por unidad (ver Series).