Gateway
=======

The GroupVAN Gateway provides transactional services for ordering, catalog
launch, invoicing and statement retrieval. These services connect buyer systems
to seller systems through the GroupVAN network.

Base URL
--------

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Environment
     - URL
   * - Production
     - ``https://gateway.groupvan.com``
   * - Staging
     - ``https://api.staging.groupvan.com``

Authentication
--------------

All Gateway endpoints require a valid JWT Bearer token in the request header.

.. code-block:: none

    Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

See :doc:`authentication` for details on generating a self-signed JWT.

Available Services
------------------

.. list-table::
   :header-rows: 1
   :widths: 20 10 35 35

   * - Service
     - Method
     - Endpoint
     - Description
   * - :doc:`item-inquiry`
     - POST
     - ``/json/federated/v3_1/item_inquiry``
     - Check pricing and availability
   * - :doc:`place-order`
     - POST
     - ``/json/federated/v3_1/place_order``
     - Submit purchase orders
   * - :doc:`punch-out`
     - POST
     - ``/auth/get_catalog_token``
     - Generate catalog session token
   * - :doc:`get-cart`
     - GET
     - ``/v2_1/catalog/cart/{cart_id}``
     - Retrieve cart from catalog session

Postman Collection
------------------

A Postman collection and environment file are available for testing and exploring the Gateway.

| :download:`Download Collection <../assets/GroupVAN_Gateway.postman_collection.json>` | :download:`Download Environment <../assets/GroupVAN_Gateway.postman_environment.json>` |

Import both files into `Postman <https://www.postman.com/>`_ to get pre-configured
requests for all endpoints.

.. dropdown:: Import Instructions

    1. Open Postman and click **Import** in the top left.
    2. Import both the collection and environment files.
    3. Select the **GroupVAN Gateway** environment from the environment dropdown.
    4. Set your ``ACCESS_TOKEN`` value in the environment variables.
    5. The ``BASE_URL`` defaults to staging. Change it to ``https://gateway.groupvan.com`` for production.
    6. Send requests. The collection uses ``ACCESS_TOKEN`` for Bearer authentication across all requests.

.. toctree::
   :maxdepth: 2

   item-inquiry
   place-order
   punch-out
   get-cart