Metadatos de pedidos

Descripción general

Order Invoicer añade automáticamente metadatos a sus pedidos para mantener la trazabilidad entre su plataforma de comercio electrónico y su software de facturación. Estos metadatos facilitan la vinculación de los pedidos con los documentos que se generan (facturas, presupuestos, pedidos de compra, etc.).

Tipos de metadatos

Metadatos de trazabilidad

Los siguientes metadatos se añaden automáticamente a cada pedido procesado:

Plataformas compatibles

Shopify

En Shopify, los metadatos se almacenan como metafields en los pedidos.

Estructura del metafield

{
  "ownerId": "gid://shopify/Order/123456789",
  "key": "invoice_url",
  "value": "https://app.sellsy.com/invoice/12345",
  "type": "url"
}

Claves de metadatos de Shopify

Acceso a los metadatos en Shopify

A través de la API de GraphQL:

query getOrderMetafields($id: ID!) {
  order(id: $id) {
    metafields(first: 10) {
      edges {
        node {
          key
          value
          type
        }
      }
    }
  }
}

A través de la interfaz de Shopify:

1. Vaya a Pedidos > Todos los pedidos
2. Haga clic en un pedido
3. En la sección Metafields, verá las URL de los documentos generados

Botón de descarga para sus clientes

Order Invoicer ofrece un bloque de aplicación que puede añadir a su tema de Shopify para permitir que sus clientes descarguen sus facturas directamente desde su cuenta de cliente.

Más información: Consulte nuestra guía de instalación del botón de descarga para la configuración completa.

WooCommerce

En WooCommerce, los metadatos se almacenan como meta_data en los pedidos.

Estructura de meta_data

{
  "meta_data": [
    {
      "key": "orderinvoicer.invoice_url",
      "value": "https://app.sellsy.com/invoice/12345"
    }
  ]
}

Claves de metadatos de WooCommerce

Acceso a los metadatos en WooCommerce

A través de la API REST:

GET /wp-json/wc/v3/orders/{id}

A través de la interfaz de WordPress:

1. Vaya a WooCommerce > Pedidos
2. Haga clic en un pedido
3. En la pestaña Datos personalizados, verá los metadatos de Order Invoicer

Uso práctico

Trazabilidad de los pedidos

Los metadatos le permiten:

• Encontrar rápidamente el documento de Sellsy correspondiente a un pedido
• Comprobar el estado de procesamiento de un pedido
• Acceder a los documentos directamente desde su plataforma de comercio electrónico
• Mantener ambos sistemas coherentes

Integración con herramientas de terceros

Puede utilizar estos metadatos para:

• Automatizar flujos de trabajo basados en las URL de los documentos
• Crear informes cruzados entre el comercio electrónico y la facturación
• Crear integraciones personalizadas
• Sincronizar estados entre plataformas

Ejemplos de uso

Script de verificación para Shopify

// Check whether an order has been processed
async function checkOrderProcessed(orderId) {
  const order = await shopify.order.get(orderId);
  const metafields = order.metafields;
  
  const invoiceUrl = metafields.find(m => m.key === 'invoice_url');
  if (invoiceUrl) {
    console.log('Commande traitée - Facture:', invoiceUrl.value);
  }
}

Script de verificación para WooCommerce

// Check whether an order has been processed
function check_order_processed($order_id) {
    $order = wc_get_order($order_id);
    $invoice_url = $order->get_meta('orderinvoicer.invoice_url');
    
    if ($invoice_url) {
        echo 'Commande traitée - Facture: ' . $invoice_url;
    }
}

Gestión de errores

Resolución de problemas