Subir y gestionar facturas con la API de Channable

Si tienes una conexión de pedidos, puedes subir y gestionar tus facturas en formato PDF para los 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 (p. ej. MediaMarkt, Decathlon, Leroy Merlin, etc.).

Antes de empezar

Para sacar el máximo provecho de esta función, asegúrate de haber considerado lo siguiente:

Necesitarás

• Una conexión de pedidos activa con pedidos existentes

• Un token de acceso a la API de Channable

• Conocimientos básicos sobre cómo funciona la API de Channable

• Pedidos existentes de un marketplace compatible

Bueno saber

• Actualmente solo puedes subir y gestionar tus tiendas web 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 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

• But

• Conrad

• La Redoute

• Praxis

• Le BHV Marais

• Home24

• Galeries LaFayette

• fonQ

• BlokkerConnect!

• Carrefour Francia

• Carrefour España

• Maisons du Monde

• Kruidvat

• Obelink

• Worten

• Douglas

• FNAC Darty Offers

• Manor

• Leen Bakker

• Conforama

• PcComponentes

• ePrice

1

Generar token de acceso a la API de Channable

Consejo: Puedes omitir este paso si ya has generado un token de acceso.

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

2. En la sección Herramientas, selecciona Channable API.

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

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

Importante: Una vez generado el token, guárdalo en un lugar seguro. Por razones de seguridad, no mostramos el token de nuevo después de generarlo. Si lo pierdes, tendrás que generar uno nuevo.

2

Encuentra y anota tus IDs de producto y pedido

1

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

Nota: Si guardas el ID de pedido de Channable cuando inicialmente recuperas y procesas los pedidos abiertos, no necesitarás volver a obtener los pedidos al enviar facturas. Puedes usar el ID de los datos que ya tienes.

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

2. Cada pedido contiene un atributo id: este es el id que debes proporcionar al subir facturas para un pedido específico.

2

OPCIÓN 2: Encontrar 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 Ajustes. Esto te llevará a tu Ajustes del proyecto.

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

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

5. Anota los IDs de pedido específicos para los que quieres subir facturas.

3

Integración para facturas (desarrollador)

En este paso, tú/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. Construye tu solicitud:

   1. Crea una petición POST al endpoint order_attachment_upload.

   2. Incluye tu token de acceso a la API en el header Authorization: Bearer tu_token_api.

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

      • attachment_type: Configurar a “INVOICE”

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

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

Para instrucciones detalladas, consulta nuestra documentación de la API de adjuntos de pedido.

Nota: Puedes enviar varias facturas por pedido. Sin embargo, algunos canales (como Amazon) solo conservan un registro de la factura más reciente, eliminando las anteriores. Para información específica sobre el comportamiento de cada canal, es mejor contactar con el equipo de soporte del marketplace.

4

Comprueba tus facturas subidas

Después de que tú/tu desarrollador envíe una factura mediante nuestra API de Channable, verifica que se haya 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 subiste la factura.

• Ve al Adjuntos del pedido en “Francia”, puedes definir este precio directamente en la

• Haz clic en Descargar factura.