Cómo hacer un pedido usando un producto personalizado

Esta guía le explicará paso a paso cómo hacer un pedido utilizando un producto personalizado de cliente a través de la API de GelatoConnect. Los productos personalizados de cliente le permiten usar sus propias configuraciones de producto al realizar pedidos, lo que simplifica el proceso y garantiza la coherencia con sus definiciones internas de producto.

Punto final de la API

POST https://order.ie.live.gelato.tech/api/v4/orders

Estructura de la solicitud

Los elementos clave para usar un Customer Product en su pedido son los campos productName y productVariant dentro del array items. Aquí tiene un ejemplo de la estructura de la solicitud:

{
    "clientId": "your-client-id",
    "orderReferenceId": "your-order-reference",
    "customerReferenceId": "your-customer-reference",
    "orderType": "order",
    "currency": "USD",
    "retailCurrency": "USD",
    "retailShippingPriceInclVat": 5.99,
    "shippingAddress": {
        "country": "US",
        "firstName": "John",
        "lastName": "Doe",
        "addressLine1": "123 Main St",
        "city": "Anytown",
        "postCode": "12345",
        "state": "CA",
        "email": "[email protected]",
        "phone": "1234567890"
    },
    "items": [
        {
            "itemReferenceId": "your-item-reference",
            "productName": "sample for order intake",
            "productVariant": {
                "paper": "a1",
                "color": "front"
            },
            "files": [
                {
                    "type": "default",
                    "url": "https://example.com/your-file.pdf"
                }
            ],
            "quantity": 1,
            "retailPriceInclVat": 79.99
        }
    ]
}

Campos clave para productos personalizados

Cuando utilices un producto personalizado, presta especial atención a estos campos en la matriz items:

productName: Este debe coincidir con el nombre de tu producto personalizado de cliente tal y como está definido en GelatoConnect.
productVariant: Este objeto contiene las opciones específicas de tu producto. Las claves y los valores deben coincidir con las opciones de variante que has configurado para tu Customer Product.

En el ejemplo anterior:

"productName": "sample for order intake",
"productVariant": {
    "paper": "a1",
    "color": "front"
}

Esta configuración indica a GelatoConnect que use el producto de cliente llamado "sample for order intake" con las opciones de papel y color especificadas.

Notas importantes

Cuando use un producto de cliente, no necesita proporcionar un productUid para el artículo. En su lugar, se utilizan los campos productName y productVariant para determinar la configuración exacta del producto.
Asegúrate de que productName coincide exactamente con el nombre de tu producto del cliente en GelatoConnect.
El objeto productVariant solo debe incluir las opciones que hayas definido para tu producto personalizado. Incluir opciones no definidas provocará un error.
El resto de la estructura de la solicitud de pedido sigue siendo la misma que en un pedido estándar. Puede incluir varios artículos, cada uno usando un producto personalizado diferente si es necesario.
Asegúrate siempre de que los archivos que facilites coincidan con los requisitos de la configuración de tu producto personalizado para el cliente.

Respuesta

Después de hacer un pedido correctamente, recibirás una respuesta con los detalles del pedido, incluido el ID del pedido, el estado de procesamiento y más. Comprueba siempre la respuesta para asegurarte de que tu pedido se haya procesado correctamente.

Solución de problemas

Si tiene problemas al hacer un pedido con un Customer Product, compruebe lo siguiente:

Comprueba que productName coincida exactamente con el nombre de producto de tu cliente.
Asegúrate de que todas las opciones obligatorias de productVariant se faciliten y coincidan con la configuración de tu producto para clientes.
Comprueba que los archivos proporcionados cumplen los requisitos de tu producto personalizado del cliente.
Comprueba que tus credenciales de API sean correctas y que tengas permiso para usar el Customer Product especificado.

[Order Intake - GCW] Realizar un pedido usando Customer Product