> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-es/pedidos/configurar-la-instalacion-de-pedidos/subir-y-gestionar-facturas-con-la-api-de-channable.md).

# Sube y gestiona facturas con Channable API

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](/list-advertise/list-and-advertise-es/pedidos/conexiones-de-pedidos/plataformas-de-comercio-electronico-compatibles-para-conexiones-de-pedidos/como-configurar-la-api-de-channable-para-una-conexion-de-pedidos.md)
* 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.

<details>

<summary>Todos los marketplaces basados en Mirakl</summary>

* 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

</details>

{% stepper %}
{% step %}

### Generar token de acceso de la API de Channable

{% hint style="success" %}
Consejo: puedes saltarte este paso si ya has generado un token de acceso.
{% endhint %}

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.

{% hint style="warning" %}
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.
{% endhint %}
{% endstep %}

{% step %}

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

{% stepper %}
{% step %}

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

{% hint style="info" %}
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.
{% endhint %}

1. Usa [Todos los pedidos V2](https://api.channable.com/v1/docs#tag/orders/operation/all_orders_v2_v2_companies__company_id__projects__project_id__orders_get) 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.
   {% endstep %}

{% step %}

#### 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.
   {% endstep %}
   {% endstepper %}
   {% endstep %}

{% step %}

### 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](https://api.channable.com/v1/docs#tag/order_attachments/operation/order_attachment_upload_companies__company_id__projects__project_id__orders__order_id__attachments_post).

{% hint style="info" %}
**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.
{% endhint %}
{% endstep %}

{% step %}

### 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**.

<figure><img src="/files/ca331420fc27ea58b492f1c3666ff80df5842fdd" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-es/pedidos/configurar-la-instalacion-de-pedidos/subir-y-gestionar-facturas-con-la-api-de-channable.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.