Subir y gestionar facturas con la API de Channable

Aprende cómo subir y gestionar facturas de pedidos con la API de Channable para los marketplaces compatibles.

Si tienes una conexión de pedidos, puedes subir y gestionar tus facturas en formato PDF para marketplaces compatibles a través de la API de Channable. Esta función está disponible para Amazon, Kaufland, bol y todos los marketplaces basados en Mirakl (por ejemplo, MediaMarkt, Decathlon, Leroy Merlin, etc.)

Antes de empezar

Para sacar el máximo partido a esta función, asegúrate de haber tenido en cuenta lo siguiente:

Vas a necesitar

• Una conexión de pedidos activa con pedidos existentes

• Un token de acceso de la API de Channable

• Entender cómo funciona la API de Channable

• Pedidos existentes de un marketplace compatible

Es bueno saber

• Actualmente, solo puedes subir y gestionar tus tiendas online con la API de Channable (no plataformas basadas en webshop)

• La API nos permite recibir información de facturas. Actualmente, no podemos recuperar facturas automáticamente desde las plataformas de conexión de pedidos.

• Esta configuración implica conectar tu sistema a Channable usando nuestra API. Es un proceso técnico que normalmente requiere un desarrollador o alguien con conocimientos de programación.

Todos los marketplaces basados en Mirakl

• MediaMarkt

• Leroy Merlin

• Bricoman

• Decathlon

• Debenhams

• Vtwonen

• ANWB

• INNO

• Pero

• Conrad

• La Redoute

• Praxis

• Le BHV Marais

• Home24

• Galeries LaFayette

• fonQ

• BlokkerConnect!

• Carrefour France

• Carrefour Spain

• Maisons du Monde

• Kruidvat

• Obelink

• Worten

• Douglas

• FNAC Darty Offers

• Manor

• Leen Bakker

• Conforama

• PcComponentes

• ePrice

1

Generar token de acceso de la API de Channable

Consejo: puedes saltarte este paso si ya has generado un token de acceso.

1. En Channable, ve a tus Ajustes de compañía.

2. En la sección de herramientas, selecciona API de Channable.

3. Toma nota de tu ID de compañía, ya que lo necesitarás más adelante.

4. Haz clic en Generar token para generar un token de compañía.

Importante: una vez que se genere tu token, guárdalo en un lugar seguro. Por motivos de seguridad, no mostramos el token otra vez después de generarlo. Si lo pierdes, tendrás que generar uno nuevo.

2

Busca y toma nota de tus IDs de producto y de pedido

1

OPCIÓN 1: obtener IDs de pedido usando la API de Channable (recomendado para desarrolladores)

Nota: si guardas el ID de pedido de Channable cuando recuperes y proceses inicialmente los pedidos abiertos, no tendrás que volver a recuperar los pedidos cuando envíes facturas. Puedes usar el ID de los datos que ya tienes.

1. Usa Todos los pedidos V2 para obtener los pedidos de Channable.

2. Cada pedido contiene un atributo id: ese es el id que necesitas proporcionar cuando subas facturas para un pedido concreto.

2

OPCIÓN 2: encontrar los IDs de pedido manualmente en Channable (recomendado para no desarrolladores)

1. En Channable, abre el proyecto con tu conexión de pedidos.

2. En la barra lateral, ve a Configuración. Eso te llevará a tus Ajustes de tienda.

3. Toma nota de tu ID de proyecto, ya que lo necesitarás en tu solicitud de API.

4. Ve a Pedidos. Verás una lista de tus pedidos importados.

5. Toma nota de los IDs de pedido concretos para los que quieres subir facturas.

3

Integración para facturas (desarrollador)

En este paso, tú o tu desarrollador escribiréis código que se comunique directamente con Channable para enviar los datos de la factura al pedido correcto.

1. Convierte tu archivo de factura de PDF a una cadena codificada en Base64.

2. Prepara tu solicitud:

   1. Crea una solicitud POST al endpoint order_attachment_upload.

   2. Incluye tu token de acceso de la API en la cabecera Authorization: Bearer your_api_token.

   3. Rellena el cuerpo de la solicitud. Debe contener:

      • attachment_type: establece en “INVOICE”

      • file: la cadena codificada en Base64 de tu archivo de factura

      • order_item_ids (opcional, solo bol): un array de IDs de artículos del pedido. Si no los añades, la factura se vinculará a todos los artículos del pedido.

Para instrucciones detalladas, consulta nuestra documentación de la API de Order Attachments.

Nota: Puedes enviar varias facturas por pedido. Sin embargo, algunos canales (como Amazon) solo guardan un registro de la última factura y eliminan las anteriores. Para información específica sobre el comportamiento de cada canal, lo mejor es contactar con el equipo de soporte de tu marketplace.

4

Comprueba tus facturas subidas

Después de que tú o tu desarrollador enviéis una factura a través de nuestra API de Channable, comprueba que se ha adjuntado correctamente dentro de Channable.

• En Channable, abre el proyecto con tu conexión de pedidos.

• Ve a Pedidos.

• Haz clic en el pedido para el que has subido la factura.

• Ve al paso de Adjuntos del pedido .

• Haz clic en Descargar factura.