PunchOut a través de la pasarela cXML

El modo pasarela permite la compra directa dentro de su aplicación de comercio electrónico sin que ésta tenga que tratar con el protocolo cXML a nivel técnico.

Gestión de clientes

La creación inicial y posterior actualización de los clientes la realiza usted a través de la interfaz web de PunchCommerce. Debe mantener los siguientes parámetros para cada cliente:

Funcionalidad cXML soportada

PunchCommerce admite PunchOut Nivel 1 y Nivel 2 directamente desde Ariba u otros sistemas que admitan el protocolo cXML.

Autenticación y reenvío en el sistema del proveedor

La autenticación en nuestra pasarela se realiza como de costumbre llamando a la dirección de entrada de PunchCommerce y transfiriendo los siguientes parámetros. Tras la autenticación correcta del cliente, se produce el reenvío a la dirección de entrada definida en la configuración del cliente (véase gestión de clientes).

La dirección de entrada se amplía con los parámetros sID (identificador de sesión) y uID (identificador de cliente), de modo que la URL final se estructura según el siguiente esquema:

    https://{hostname}.{domain}.{tld}?sID={UUID}&uID={customer.identifier}

La autenticación en el sistema del proveedor es responsabilidad de éste. Proporcionamos plugins para Shopware 5 y 6 a través de Shopware Store:

• https://store.shopware.com/netzd94997432810f/punchcommerce-fuer-shopware-5.html
• https://store.shopware.com/netzd58963559333f/punchcommerce-fuer-shopware-6.html

Transmisión de la cesta de la compra (PunchOut)

Una vez que el cliente ha completado su proceso de compra, la aplicación de comercio electrónico del proveedor debe transmitir la cesta de la compra de vuelta a nuestra solución de pasarela como un objeto JSON junto con el identificador de sesión (sID).

Para ello debe ejecutarse una petición http-POST a la dirección https://www.punchcommerce.de/gateway/v3/return?sID={UUID}. El cuerpo de la petición debe contener la cesta de la compra análoga a la siguiente estructura.

{
  "cesta":[
        {
            "product_ordernumber": "10001",
            "product_name": "Marco de escalada",
            "quantity": 1.50
            "item_price": 100,
            "price": 178.50
            "price_net": 150,
            "tax_rate": 19,
            "producto": {
                "id": "42",
                "ordernumber": "10001",
                "marca": "red_dirección",
                "brand_ordernumber": "999999",
                "customer_ordernumber": "2342343295649586"
                "title": "Marco de escalada",
                "category": "Equipamiento de juego para niños",
                "description": "Un parque infantil educativo para trepar",
                "description_long": "Nullam quis risus eget urna mollis ornare vel eu leo. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Vestibulum id ligula porta felis euismod semper. Donec id elit non mi porta gravida at eget metus",
                "image_url": "",
                "price": 2623,
                "tax_rate": 19,
                "purchase_unit": null,
                "reference_unit": null,
                "unit": null,
                "unit_name": null,
                "packaging_unit": "pallet",
                "peso": 230
                "shipping_time": 23,
                "classification_type": "ECLASS",
                "classification": "90909090",
                "custom_field1": "0.19",
                "custom_field2": "BX",
                ...
                "custom_field10": null
            }
        }
    ]
}

PunchCommerce aplica la asignación de campos definida para su cliente a la cesta de la compra y transmite la cesta de la compra al sistema ERP de llamada a través del protocolo cXML.

Documentación Swagger

Puede encontrar la especificación actual de la API en: https://www.punchcommerce.de/swagger