Importar una factura

📘
Una vez la boleta/factura esté importada

Yuju la enviará automáticamente a todos los canales de ventas conectados, según la configuración que tengas (revisar con tu KAM asignado la configuración de esta funcionalidad).

Endpoint

POST https://api.tp.yuju.io/invoices

Modelo de datos para una factura

Campo	Descripción	Requerido
serie	Serie de la factura	✅
folio	Folio de la factura	✅
document_type	Tipo de documento. Opciones: `invoice`, `ticket`. `invoice` es el valor por defecto.	✅
invoice_date	Fecha de creación de la factura	✅
name	Razón social de la entidad a facturar	✅
taxid	RFC, RUT, DNI	✅
country	(ISO 3166-1 alpha-3) País donde se está emitiendo la factura	✅
currency	(ISO 4217) Moneda utilizada para facturar	✅
subtotal	Subtotal facturado	✅
iva	Impuestos facturados	✅
total	Total facturado	✅
[orders]	Lista de objetos de ventas facturadas	✅
[files]	Lista de archivos que se adjuntarán a la factura. Acepta ambos formatos a la vez: PDF y/o XML.	❌

Modelo de datos para un objeto de venta facturada

Campo	Descripción	Requerido
id_shop	Identificador de la tienda de Yuju	✅
id_channel	Identificador del canal	✅
id_order	Identificador de la venta	✅
reference	Referencia de la venta	✅
[items]	Lista de productos facturados	✅

Modelo de datos para un objeto de producto facturado

Campo	Descripción	Requerido
sku	SKU del producto facturado	✅

Modelo de datos para un archivo adjunto

Campo	Descripción	Requerido
name	Nombre del archivo (debe ser único para la factura)	✅
base64	Contenido del archivo codificado en base64	✅
send_to_marketplace	Se reciben dos valores: 1 o 0 0: No se envía a los marketplaces. Solo se sube a Yuju. 1: Se sube el documento a Yuju y Yuju lo envía a los canales.	✅

👍
¡También puedes adjuntar documentos!

Para files, solo se permiten archivos en formato XML o PDF.

Aunque algún campo sea requerido, si no necesitas o no deseas llenarlo, por favor complétalo con un valor por defecto.

Si no enviaste la boleta/factura en el primer llamado, envia lo que falta en un proceso de actualización. Ver cómo actualizar una factura.

{
  "serie": "A",
  "folio": 1,
  "invoice_date": "2021-04-22T22:30:37",
  "name": "Comercializadora de occidente s.a de c.v.",
  "taxid": "COJ8812011ABC",
  "country": "MEX",
  "currency": "MXN",
  "subtotal": 10000,
  "iva": 1900,
  "total": 11900,
  "orders": [
    {
      "id_shop": 205,
      "id_channel": 15,
      "id_order": "ABC123",
      "reference": "aaaa-bbbb-cccc-dddd",
      "items": [
        {
          "sku": "123456789ABC"
        }
      ]
    }
  ],
  "files": [
    {
      "name": "factura",
      "base64": "JVBERiB0ZA...",
      "send_to_marketplace": 1
    },
    {
      "name": "comprobante_fiscal",
      "base64": "H4sIA...",
      "send_to_marketplace": 0
    }
  ]
}

Notas:

En files[].name no debe incluirse la extensión del archivo. El sistema Yuju la agrega automáticamente según el contenido detectado.
Si el archivo es de tipo XML, debe contener la etiqueta <xml…>.

Respuesta

Código 200:

Cuando la importación se realiza con éxito, el servidor responde con:

{
    "pk": "JM27HcRI2MHqalAled5LnvRKHoGwoNwRNhdl",
    "message": "Processed successfully"
}