Traducida del inglés. Si hay alguna diferencia, la página en inglés es la referencia. Leer en inglés
Exportaciones
Exportaciones CSV de productos y pedidos: cada formato, su delimitador y columnas, y cómo sus ids coinciden con la API.
Todas las exportaciones son CSV, UTF-8 con BOM (EF BB BF, para que Excel abra bien los acentos), con una fila de cabecera al principio y finales de línea \n. Se devuelven en streaming como text/csv; charset=utf-8 con Content-Disposition: attachment.
Lo que la API escribe de forma distinta a la descarga del panel (por lo demás, mismas columnas):
- los ids de producto son
prod_<hex>, exactamente como enGET /products(el archivo del panel tiene el id hexadecimal sin prefijo); - los precios tienen exactamente 2 decimales como texto (
"15.90"), igual que la API; - las exportaciones de pedidos terminan con el id de pedido de la API y las referencias del canal (columnas más abajo).
Un archivo de productos exportado a través de la API se puede volver a importar con POST /imports (csv): los ids prod_… se reconocen, así que los productos existentes se actualizan, no se duplican.
Valores: los campos de texto que pueden contener el delimitador van entre "…"; una " dentro de ellos se convierte en '; # se elimina de todas las filas (compatibilidad con versiones antiguas). Celda vacía = sin valor.
Productos: format=standard (predeterminado)
Delimitador ,. Una fila por variante; las columnas a nivel de producto (título, descripción, nombres de opción, imágenes, marca, etiquetas, categoría, peso, dimensiones) se rellenan solo en la primera fila del producto, y las filas de variantes siguientes repiten solo id y las columnas de variante.
| Columna | Significado | Ejemplo |
|---|---|---|
id | Id del producto (prod_…), en todas las filas | prod_6ad22d0ee891b034a5693aa0 |
title | Título del producto (primera fila) | Ceramic mug |
description | Descripción del producto (se admite HTML, primera fila) | "<p>Hand made</p>" |
option_1_name | Nombre de la primera opción (primera fila) | Size |
option_1_value | Valor de esta variante | M |
option_2_name / option_2_value | Segunda opción | Color / Blue |
option_3_name / option_3_value | Tercera opción | |
sku | SKU de la variante | TSHIRT-M-BLUE |
gtin | Código de barras de la variante (EAN/UPC) | 0080694175826 |
asin | ASIN de Amazon | B009DEA0SQ |
quantity | Stock (0 si está vacío) | 25 |
price | Precio en la moneda de la tienda, 2 decimales | 15.90 |
image_link | URL de la imagen principal del producto (primera fila) | https://…/a.jpg |
additional_image_link | URL de las demás imágenes del producto, separadas por comas entre comillas (primera fila) | |
variant_image_link | Imagen propia de esta variante | |
variant_additional_image_link | Otras imágenes de esta variante | |
brand | Marca (primera fila) | Acme |
tags | Etiquetas, separadas por comas entre comillas (primera fila) | "mug,kitchen" |
category | Etiqueta de categoría propia del vendedor (primera fila) | Kitchen |
weight / weight_unit | Peso y unidad (primera fila) | 0.4 / kg |
height / width / length / dimensions_units | Dimensiones y unidad (primera fila) | 10 / 8 / 8 / cm |
Productos: format=inventory
Delimitador ,. Una fila por variante. Centrado en stock y precio.
| Columna | Significado | Ejemplo |
|---|---|---|
id | Id del producto (prod_…) | prod_6ad22d0ee891b034a5693aa0 |
name | Título del producto (solo en la primera fila del producto) | Cotton T-shirt |
option_1_name … option_3_value | Como en standard | |
sku, gtin, asin | Como en standard | |
quantity | Stock | 3 |
price | Precio, 2 decimales | 19.90 |
variant_image_link, variant_additional_image_link | Como en standard |
Productos: format=google
Delimitador | (barra vertical; | y # se eliminan de títulos y descripciones). Una fila por producto, construida a partir de su primera variante (feed de Google Merchant Center). Los productos que requieren atención se excluyen.
| Columna | Significado | Ejemplo |
|---|---|---|
id | Id de la oferta: el SKU de la primera variante o, si no, el id del producto (prod_…) | MUG-1 |
title | Título (sin saltos de línea) | Ceramic mug |
description | Descripción como texto plano (sin HTML ni saltos de línea) | Hand made |
link | La URL del producto en el primer marketplace en el que está publicado o, si no, su página en la tienda online de Nembol | https://nembolitalia.myshopify.com/products/ceramic-mug |
image_link | Imagen principal | https://…/a.jpg |
additional_image_link | Otras imágenes, separadas por comas | |
availability | Siempre in stock | in stock |
price | Precio de la primera variante, 2 decimales, sin moneda (añádela en Merchant Center; es la moneda de la tienda) | 15.90 |
brand | Marca | Acme |
gtin | Código de barras de la primera variante | 0080694175826 |
condition | Siempre new | new |
google_product_category | Siempre vacío (configúralo en Merchant Center) |
Pedidos: format=standard (predeterminado)
Delimitador ; (punto y coma). Una fila por línea de pedido; las columnas a nivel de pedido están solo en la primera fila del pedido.
| Columna | Significado | Ejemplo |
|---|---|---|
Order | El número de pedido que el canal muestra al vendedor (Shopify "#1011" → 1011), en todas las filas | 1011 |
Channel | Canal (primera fila) | shopify |
Date | Fecha del pedido YYYY-MM-DD HH:mm:ss (primera fila) | 2026-10-16 21:00:00 |
Title | Título de la línea | Cotton T-shirt |
SKU | SKU de la línea | TSHIRT-S-RED |
Variant | Nombre de la variante | S / Red |
Quantity | Cantidad | 1 |
Item price | Precio unitario, 2 decimales | 9.90 |
Total price | Suma de las líneas (primera fila) | 19.80 |
Address1, Address2, City, Zip, Province, Country | Dirección de envío (primera fila) | |
Email, Name, Phone | Comprador (primera fila) | |
Currency | Moneda del pedido (primera fila) | USD |
Subtotal, Shipping, Discount, Tax | Desglose de importes cuando el canal lo comunica (primera fila; vacío en pedidos importados antes de que se registraran los impuestos) | 19.80 / 5.00 / 0.00 / 1.60 |
Tax remitted by | seller, o el marketplace que recaudó el impuesto (por ejemplo, etsy) | seller |
Order total | Lo que pagó el comprador (primera fila) | 26.40 |
Order ID | Solo API: el id del pedido en la API (ord_…, igual que en GET /orders), en todas las filas | ord_057ca3ae7912e009d01612d7 |
Order ID on channel | Solo API: el id de pedido propio del canal, = order_id_on_channel en la API, en todas las filas | 18968716083351 |
Status | Solo API: el estado del pedido, como status en GET /orders (awaiting_shipment, shipped, canceled, refunded…), en todas las filas. Los pedidos cancelados y reembolsados están en este archivo: filtra por esta columna para los totales de ventas | shipped |
Pedidos: format=quickbooks
Delimitador ,. Formato de importación de facturas de QuickBooks Online (Settings → Import data → Invoices): una fila por línea de pedido, con las columnas de la factura repetidas en cada fila. Las columnas obligatorias de QuickBooks no cambian; la API añade dos columnas al final, que la pantalla de asignación de QuickBooks te permite omitir. Los pedidos cancelados y reembolsados se excluyen, así que nunca se convierten en facturas; los pedidos reembolsados parcialmente se mantienen, con sus importes originales (registra el reembolso en QuickBooks).
| Columna | Significado | Ejemplo |
|---|---|---|
InvoiceNo | <channel>-<channel order id> (único por pedido del canal) | shopify-18968716083351 |
Customer | Nombre del comprador o, si no, su email o, si no, <channel> buyer | Test Buyer |
InvoiceDate / DueDate | Fecha del pedido YYYY-MM-DD (los pedidos de marketplace ya están pagados: vencen en la fecha de la factura) | 2026-10-16 |
Item(Product/Service) | SKU o, si no, título (≤ 100 caracteres) | TSHIRT-S-RED |
ItemDescription | Título y variante | Cotton T-shirt — S / Red |
ItemQuantity | Cantidad | 1 |
ItemRate | Precio unitario, 2 decimales | 9.90 |
ItemAmount | Precio × cantidad, 2 decimales | 9.90 |
Currency | Moneda de la línea | USD |
ItemTaxAmount | Impuesto del pedido, solo en la primera fila del pedido | 1.60 |
OrderId | Solo API: id del pedido en la API (ord_…), en todas las filas | ord_057ca3ae7912e009d01612d7 |
OrderNumber | Solo API: el número que muestra el canal (1011) | 1011 |
Un pedido, tres referencias
| Dónde | Valor para el pedido de Shopify #1011 |
|---|---|
Id del pedido en la API (GET /orders, exportaciones Order ID / OrderId) | ord_057ca3ae7912e009d01612d7 |
Id propio del canal (order_id_on_channel, Order ID on channel en standard, dentro de InvoiceNo en QuickBooks) | 18968716083351 |
Número que el vendedor ve en el canal (number en la API, Order en standard, OrderNumber en QuickBooks) | 1011 |
Relaciona las exportaciones con la API mediante Order ID / OrderId (pedidos) e id (productos).
Última actualización el 20 de octubre de 2026
¿Necesitas ayuda?
Escríbenos y te responde una persona, normalmente en un día laborable.
Gestionar el envío de pedidos
Obtén los pedidos con la dirección de envío completa, márcalos como enviados, añade el seguimiento y avisa al marketplace.
Importar productos
Trae a Nembol el catálogo de un canal conectado, o un CSV, desde tu app o tu agente: solo elementos nuevos, vinculación por SKU, filtros para una importación, progreso en directo y deshacer.