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 API de pedidos le da la capacidad de crear pedidos y recuperar información detallada de pedidos. Antes de crear un pedido, debe verificar la disponibilidad de los artículos individuales mediante la interfaz de programación de aplicaciones (API) de inventario y precios. 

Para realizar un pedido (de prueba o producción), deben tener un perfil de pago apto para la API guardado en la cuenta de su empresa. Para obtener más información, consulte la sección Primeros pasos para conocer más sobre la creación de cuentas de empresa y perfiles de pago. Para seleccionar un perfil de pago para usar de referencia con su pedido, use la API de perfil de pago. En la respuesta solo se devolverán los perfiles de pago elegibles para la API. 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).

Los datos devueltos por el punto final de la prueba simulan la información devuelta por una orden de producción (los datos son meramente demostrativos y no representan datos procesados). Cuando esté listo para realizar un pedido de producción, revise todos los parámetros que desea enviar en la carga útil de la solicitud y utilice use el método "POST" del protocolo de transferencia de hipertexto (HTTP) al punto final de producción. 

NOTE: Los campos customerOrderComments (comentarios del pedido del cliente) y customerItemComments (comentarios del artículo del cliente) son matrices de texto de paso que se devolverán en la respuesta de recuperación del pedido. Los 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. Identifíquese con la clave API y la palabra secreta asignadas.
2. Envíe una consulta a la API de inventario y precios para recuperar la disponibilidad del producto y los precios actuales. 
3. La API responderá con un código de estado, 200 OK, y una respuesta de notación de objetos JavaScript (JSON) que contiene los datos de los productos solicitados.
   
4. Después de confirmar la disponibilidad con la API de inventario y precios, construya su pedido con la carga útil deseada y envíelo a la API de pedidos.
   
5. La API responderá con un código de estado, 201 OK y un JSON que contenga el acuse de recibo del pedido. 
   

Ejemplo de respuesta: