API de pedidos

Creación de pedidos

Punto final de la prueba: 
https://transact.ti.com/v2/store/orders/test

Punto final de producción:
https://transact.ti.com/v2/store/orders/

La interfaz de programación de aplicaciones (API) de pedidos le permite crear y gestionar pedidos directamente desde el sistema. Recupere información detallada de los pedidos para mejorar el seguimiento y la gestión.

 

Antes de comenzar:

  • Verifique el inventario y los precios: antes de crear un pedido, utilice la API de inventario y precios para confirmar la disponibilidad y los precios de los artículos individuales.
  • Habilite el perfil de pago de la API: necesita un perfil de pago apto para API configurado en la cuenta de su empresa. Consulte la guía “Introducción” para obtener detalles sobre la creación de cuentas y perfiles.
  • Si falta un perfil de pago: compruebe que el perfil de pago esté completo y que se agregó un método de pago aprobado (consulte la información de pago para obtener más información).


Pruebas:

Utilice el punto final de pruebas (https://transact.ti.com/v2/store/orders/test) para simular el proceso de creación del pedido y la respuesta. Recuerde, estos datos son solo para fines de demostración.

Comentarios del pedido:

  • Los campos “customerOrderComments” y “customerItemComments” le permiten agregar información adicional con su pedido.
  • Estos datos son para uso exclusivo del cliente y TI no los valida.
  • En el ejemplo siguiente, la matriz “customerOrderComments” se utiliza para pasar una matriz de cadenas delimitadas por tuberías para especificar el número de trabajo y el nombre de la persona que realiza el pedido.

Ejemplo:

    "customerOrderComments": [
      {
        "message": "jobNumber|54851-50"
      },
      {
        "message": "orderedBy|John Smith"
      } 
 ]    

Flujo de creación de pedidos:

  1. Autentíquese con su clave de API y palabra secreta asignadas.
  2. Verifique la disponibilidad del producto y los precios actuales mediante la API de inventario y precios.
  3. Recibirá una respuesta con un código de estado (200 OK) y una respuesta JSON que contiene los datos del producto solicitado.
  4. Después de confirmar la disponibilidad con la API de inventario y precios, arme su pedido con la carga útil deseada y envíelo a la API de pedidos.
  5. Recibirá una respuesta con un código de estado (201 OK) y un acuse de recibo en formato JSON para su pedido. 

 

#!/bin/bash
curl --request POST \
--url 'https://transact.ti.com/v2/store/orders/test' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <


Ejemplo de respuesta:

{
  "orderNumber": 0,
  "orderStatus": "string",
  "customerPurchaseOrderNumber": "string",
  "subTotal": 0,
  "totalPrice": 0,
  "lineItems": [
    {
      "tiPartNumber": "string",
      "tiPartDescription": "string",
      "quantity": "string",
      "status": "string",
      "unitPrice": 0,
      "customReelIndicator": true
    }
  ],
  "shippingAddress": [
    {
      "addressType": "string",
      "firstName": "string",
      "lastName": "string",
      "company": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "town": "string",
      "state": "string",
      "postalCode": "string",
      "country": "string",
      "email": "string",
      "phoneNumber": "string",
      "companyURL": "string"
    }
  ],
  "billingAddress": [
    {
      "addressType": "string",
      "firstName": "string",
      "lastName": "string",
      "company": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "town": "string",
      "state": "string",
      "postalCode": "string",
      "country": "string",
      "email": "string",
      "phoneNumber": "string",
      "companyURL": "string"
    }
  ],
  "orderMessages": [
    {
      "code": "string",
      "type": "string",
      "Message": "string"
    }
  ],
  "customerOrderComments": [
    {
      "message": "string"
    }
  ],
  "orderPlacedTime": "string",
  "paymentType": "string",
  "currencyISO": "string",
  "totalTax": 0,
  "checkoutProfileIdentifier": "string",
  "totalDeliveryCost": 0,
  "totalDiscount": 0,
  "couponCodes": "string"
}