Índice.
1. Subida de facturas y envío al marketplace.
1.1. Facturación externa.
1.2. Creación.
1.3. Obtener información de una factura.
3. Agregar documentos a una factura.
4. Eliminar documentos de una factura.
5. Lanzar facturas a los marketplaces.
1. Subida de facturas y envío al marketplace.
Ahora desde Yuju puedes administrar y generar facturas de una manera más fácil
con la posibilidad de enviarla a tus compradores.
Parte de este desarrollo está también enfocado en permitir la subida de facturas generadas en tu sistema y enviarlas hacia los marketplaces. Este último punto será el que definiremos a continuación.
1.1. Facturación externa.
Nos permite subir la información de facturación a Yuju para llevar una relación con las ventas así como la posibilidad de mandar las facturas a los canales.
Endpoints:
Creación de facturas:
POST /shops/{shop_pk}/invoices/
Obtener información de una factura:
GET /shops/{shop_pk}/invoices/{invoice_pk}/
Actualizar una factura:
PUT /shops/{shop_pk}/invoices/{invoice_pk}/
Agregar documentos a una factura:
POST /shops/{shop_pk}/invoices/{invoice_pk}/files/
Eliminar documents en una factura:
DELETE /shops/{shop_pk}/invoices/{invoice_pk}/files/
Lanzar factura a los marketplaces:
POST /shops/{shop_pk}/invoices/{invoice_pk}/send/
1.2. Creación.
POST /shops/{shop_pk}/invoices/
● serie - Serie de la factura
● folio - Folio de la factura
● document_type - Tipo de documento. Opciones:
○ invoice: Documento fiscal, valor por defecto.
○ ticket: Nota o boleta de compra.
● 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 4227) moneda utilizada para facturar
● subtotal - Subtotal facturado
● iva - Impuestos facturados
● total - Total facturado
● orders - Ventas facturadas
○ shop_pk: Identificador de la tienda
○ marketplace_pk: Identificador del canal
○ order_pk: Identificador de la venta
○ reference: Referencia de la venta
○ items - Productos facturados
■ sku - SKU del producto facturado
1.3. Obtener información de una factura.
GET /shops/{shop_pk}/invoices/{invoice_pk}
2. Actualizar una factura.
PUT /shops/{shop_pk}/invoices/{invoice_pk}
Campos actualizables:
● serie - Serie de la factura.
● folio - Folio de la factura.
● 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 4227) moneda utilizada para facturar.
● subtotal - Subtotal facturado.
● iva - Impuestos facturados.
● total - Total facturado.
Campos no actualizables:
● orders
3. Agregar documentos a una factura.
POST /shops/{shop_pk}/invoices/{invoice_pk}/files/
files - Es una lista de archivos que vamos a subir.
○ name - Nombre del archivo con extensión (el valor debe ser único).
○ base64 - Contenido del archivo en base64.
○ send_to_marketplaces - marca el archivo para ser enviado a los marketplaces.
1 = Se debe de enviar.
0 = No se debe de enviar.
4. Eliminar documentos a una factura.
DELETE /shops/{shop_pk}/invoices/{invoice_pk}/files/
● files - Es una lista con los nombres de los archivos que vamos a eliminar.
5. Lanzar factura a los marketplaces.
POST /shops/{shop_pk}/invoices/{invoice_pk}/send/
Este endpoint nos permite definir el momento en que se quiere mandar la factura al marketplace. Se recomienda mandar la factura una vez que se haya completado todo el proceso de subir los archivos ya que en caso que se mande con los archivos incompletos el marketplace podría no aceptar modificaciones y/o agregar nuevos archivos
Para cualquier duda y/o aclaración, ponte en contacto con tu KAM asignado o escribiendo a soporte@yuju.io.