Documentación

Importar una factura

Este endpoint permite importar una factura a Yuju y asociarla a uno o varios pedidos.

Suggest Edits

📘

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 /invoices

Modelo de datos para una factura

CampoDescripciónRequerido
serieSerie de la factura✅
folioFolio de la factura✅
document_typeTipo de documento. Opciones: invoice, ticket. invoice es el valor por defecto.✅
invoice_dateFecha de creación de la factura✅
nameRazón social de la entidad a facturar✅
taxidRFC, RUT, DNI✅
country(ISO 3166-1 alpha-3) País donde se está emitiendo la factura✅
currency(ISO 4217) Moneda utilizada para facturar✅
subtotalSubtotal facturado✅
ivaImpuestos facturados✅
totalTotal 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

CampoDescripciónRequerido
id_shopIdentificador de la tienda de Yuju✅
id_channelIdentificador del canal✅
id_orderIdentificador de la venta✅
referenceReferencia de la venta✅
[items]Lista de productos facturados✅

Modelo de datos para un objeto de producto facturado

CampoDescripciónRequerido
skuSKU del producto facturado✅

Modelo de datos para un archivo adjunto

CampoDescripciónRequerido
nameNombre del archivo con extensión (debe ser único para la factura)✅
base64Contenido del archivo codificado en base64✅
send_to_marketplaceSe 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!

  1. Para files, solo se permiten archivos en formato XML o PDF.
  2. Aunque algún campo sea requerido, si no necesitas o no deseas llenarlo, por favor complétalo con un valor por defecto.
  3. 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.pdf",
      "base64": "JVBERiB0ZA...",
      "send_to_marketplace": 1
    },
    {
      "name": "comprobante_fiscal.xml",
      "base64": "H4sIA...",
      "send_to_marketplace": 0
    }
  ]
}

Respuesta

Código 200:

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

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

Updated 15 days ago