Sidebar - Backlog

Información general

Para comenzar con la suite API de pedidos pendientes de TI, siga estos pasos: 

  1. Cumpla los requisitos previos para el acceso y el desarrollo 
  2. Reciba los códigos de identificación del cliente 
  3. Revise el flujo típico de pedidos con la suite API de pedidos pendientes
  4. Identifíquese para recibir un token de acceso
  5. Aprenda a crear y recuperar cotizaciones de productos de TI
  6. Aprenda a crear un pedido de prueba
  7. Aprenda a acceder a la información de su pedido
  8. Aprenda a cambiar un pedido 
  9. Aprenda a recuperar el seguimiento de envíos
  10. Aprenda a recuperar un documento financiero
  11. Aprenda a crear avisos de remesas
  12. Obtenga soporte

 

Paso 1: Requisitos previos para la configuración y revisión del proceso de incorporación

Solo los clientes aprobados pueden crear aplicaciones mediante la suite API de pedidos pendientes. Para obtener la autorización:

  1. Cree una cuenta myTI o inicie sesión en su cuenta myTI existente
  2. Asocie su cuenta myTI con una cuenta de empresa  
  3. Inicie sesión en el Portal API
  4. Revise el proceso de incorporación de clientes
  5. Envíe el formulario de incorporación de clientes y revise
  6. Configure a TI como proveedor en su sistema interno
  7. Revise la guía de negocios de API para obtener información sobre negocios y procesos

 

Paso 2: Recibir los códigos de identificación del cliente

  1. Después de completar el formulario de incorporación del cliente, TI le proporcionará los códigos de identificación del cliente de su centro. Estos códigos se utilizan para la conectividad API de pedidos pendientes, órdenes de cambio y cotizaciones. Estos códigos también aparecen en varios de los documentos salientes que se envían al cliente:
    1. El código de envío es adonde TI envía el producto
    2. El código de identificación del cliente final es solo para fabricantes por contrato aprobados (CM) o clientes que compran en nombre de otro cliente
  2. La información del proveedor de TI con detalles bancarios también se proporcionará con los códigos de identificación del cliente a través de una notificación por correo electrónico
    1. El cliente puede acceder a la información de proveedores e información financiera de TI a través de un PDF vinculado. Esto se proporciona para facilitar la configuración del proveedor en su sistema. El PDF incluirá la dirección postal de TI, el código NAICS, el número de identificación fiscal federal, los ingresos anuales y la información de pago estándar. El PDF también incluye el enlace a nuestros informes anuales, informe de ciudadanía y certificaciones de calidad. En función de su respuesta al formulario de incorporación de clientes, le indicaremos en esta notificación por correo electrónico el país de nuestro banco para que lo utilice en la configuración de proveedores.

 

Paso 3: Descripción general del flujo de pedidos

  1. El formato de la API estándar de TI consiste en la recuperación, si se prefiere utilizar la API de notificaciones, consulte la Guía de negocios de API
  2. Identifíquese con la clave API y la palabra secreta asignadas
  3. Asegúrese de que las piezas que desea solicitar estén incluidas en el acuerdo de precios de TI. De no ser así, puede crear una cotización
  4. Cree su pedido con la carga útil deseada y envíelo a la API de pedidos pendientes
  5. La API responderá con un código de estado, 201 creado y un JSON que contenga el acuse de recibo del pedido
  6. Consulte la API de pedidos pendientes para conocer el estado y los detalles adicionales del pedido
  7. Después del procesamiento del pedido, recupere el seguimiento de envíos a través de la API de recuperación de avisos de envíos anticipados (ASN) y las facturas a través de la API de recuperación de documentos financieros
  8. La API de aviso de remesas es obligatoria. Llame a la API de avisos de remesas para enviar información de remesas a TI
  9. ¿Le interesa ver un código de ejemplo para cada uno de estos pasos? Descargue nuestro código de ejemplo

 

Paso 4: Autenticar

Los conjuntos de API de TI están protegidos con OAuth 2.0. Antes de utilizar el conjunto de API, es necesario autenticarse y obtener un token de acceso.  Consulte la página de autenticación para más información.

curl --request POST \   
       --url https://transact.ti.com/v1/oauth/accesstoken \   
       --header 'Content-Type: application/x-www-form-urlencoded' \   
       --data grant_type=client_credentials \   
       --data client_id=<<INSERT YOUR CLIENT KEY>> \   
       --data client_secret=<<INSERT YOUR SECRET>>

Paso 5: Crear y recuperar cotizaciones para productos de TI

La API de cotizaciones permite a los clientes autorizados crear una cotización dentro del sistema empresarial de TI. Se puede presentar una cotización para varias piezas y cantidades. Recibirá un número de cotización como referencia.  Las respuestas a las cotizaciones suelen estar disponibles de 30 minutos a 24 horas después de enviar una cotización. El Estado de cotización indica si una cotización es aceptada, rechazada o modificada; el Estado indica si una partida está pendiente, licitada o no licitada. Para obtener más información, consulte la página API de cotizaciones pendientes.

Ejemplo de creación de solicitud de cotización:

curl --request POST \
--url 'https://transact-pre.ti.com/v2/backlog/quotes' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "quote": {
    "customerQuoteNumber": "TEST-AW-20200224-G115",
    "quoteReason": "CD",
    "contactName": "John Smith",
    "contactEmailAddress": "john-smith@test-customer123.com",
    "contactPhoneNumber": "888-888-8888",
    "endCustomerCompanyName": "Company XYZ",
    "endCustomerNumber": "",
    "endCustomerWebsite": "https://www.companyxyz.com",
    "lineItems": [
      {
        "tiPartNumber": "SN74LS00N",
        "quantity": 2500,
        "requestedUnitPrice": 1.2,
        "requestedUnitPriceCurrencyCode": "USD",
        "competitorName": "Competitor N",
        "competitorPartNumber": "SNKLLPO23",
        "competitorUnitPrice": 1.43,
        "competitorCurrencyCode": "USD"
      }
    ]
  }
}
DATA

Ejemplo de respuesta al crear una cotización:

{
	"customerQuoteNumber": "TEST-AW-20200224-G115",
	"quoteNumber": "26645389",
	"quoteReason": "CD",
	"endCustomerCompanyName": "Company XYZ",
	"quoteStatus": "Accept",
	"quoteStartDate": "2023-03-28T00:00:00Z",
	"quoteEndDate": "2023-09-24T00:00:00Z",
	"lineItems": [
		{
			"tiLineItemNumber": 10,
			"tiPartNumber": "SN74LS00N",
			"quantity": 2500,
			"requestedUnitPrice": 1.2,
			"status": "Pending"
		}
	]
}

Ejemplo de solicitud de recuperación de una cotización:

curl --request GET \   
--url 'https://transact-pre.ti.com/v2/backlog/quotes/?quoteNumber={quoteNumber}' \
--header 'Authorization: Bearer {access_token}' \

Ejemplo de respuesta de recuperación de una cotización:

{
	"customerQuoteNumber": "TEST-AW-20200224-G115",
	"quoteNumber": "26645389",
	"quoteReason": "CD",
	"endCustomerCompanyName": "Company XYZ",
	"quoteStatus": "Accept",
	"quoteStartDate": "2023-03-28T00:00:00Z",
	"quoteEndDate": "2023-09-24T00:00:00Z",
	"lineItems": [
		{
			"tiLineItemNumber": 10,
			"tiPartNumber": "SN74LS00N",
			"quantity": 2500,
			"requestedUnitPrice": 1.2,
			"status": "Pending"
		}
	]
}

Paso 6: Crear un pedido de prueba

Los pedidos de pruebas pendientes se simulan en nuestro entorno de pruebas de preproducción y están destinados específicamente a ayudar en el desarrollo de la aplicación del cliente.  La información devuelta son datos de prueba simulados con fines demostrativos únicamente y no representan información procesada.  

Url de creación de orden de prueba de pedidos pendientes: https://transact-pre.ti.com/v2/backlog/orders (preproducción)

  1. Para realizar un pedido (de prueba o de producción), se debe aprobar al cliente, configurar los ajustes y completar el proceso de incorporación.
  2. Una vez que el cliente haya realizado con éxito una prueba de entrada y cambio de pedido, siga los escenarios de prueba de aceptación del usuario en la guía de negocios de API para completar la fase de prueba.

Cuando esté listo para realizar un pedido pendiente de producción, revise todos los parámetros que desea enviar en la carga útil de la solicitud y utilice las versiones de producción de la API de autenticación y creación de pedidos pendientes (URL: https://transact.ti.com/v1/oauth and https://transact.ti.com/v2/backlog/orders).  Si experimenta tiempos de espera en la conexión, especialmente en pedidos con más de 30 líneas de pedido, se recomienda que establezca el tiempo de espera de la conexión en 5 minutos para evitar errores de tiempo de espera.

Para obtener más información sobre los pedidos de producción y las pruebas, consulte la página de documentación de la API de pedidos pendientes.

Ejemplo de solicitud de creación de un pedido de prueba pendiente: 

curl --request POST \
--url 'https://transact-pre.ti.com/v2/backlog/orders' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "order": {
    "customerPurchaseOrderNumber": "TestPO-230405-01",
    "shipToAccountNumber": "12354978",
    "endCustomerCompanyName": "Company B",
    "lineItems": [
      {
        "customerLineItemNumber": "1",
        "tiPartNumber": "SN7407N",
        "customerPartNumber": "TILMNOP",
        "customerAnticipatedUnitPrice": 0.30,
        "customerCurrencyCode": "USD",
        "schedules": [
          {
            "requestedQuantity": 2000,
            "requestedDeliveryDate": "2023-05-01"
          }
        ]
      },
      {
        "customerLineItemNumber": "2",
        "tiPartNumber": "DRV8304SRHAR",
        "customerPartNumber": "TIABCDEF",
        "customerAnticipatedUnitPrice": 1.00,
        "customerCurrencyCode": "USD",
        "schedules": [
          {
            "requestedQuantity": 5000,
            "requestedDeliveryDate": "2023-06-01"
          }
        ]
      },
      {
        "customerLineItemNumber": "3",
        "tiPartNumber": "SN7407DR",
        "customerPartNumber": "TIABCDEF",
        "customerAnticipatedUnitPrice": 0.22,
        "customerCurrencyCode": "USD",
        "schedules": [
          {
            "requestedQuantity": 7500,
            "requestedDeliveryDate": "2023-06-01"
          }
        ]
      }
    ]
  }
}

Ejemplo de respuesta para la creación de un pedido de prueba pendiente: 

{
	"orders": [
		{
			"orderNumber": "1019621260",
			"orderDate": "2023-04-05 14:31:16",
			"customerPurchaseOrderNumber": "TestPO-230405-01",
			"orderStatus": "OPEN",
			"lineItems": [
				{
					"tiLineItemNumber": "000010",
					"tiPartNumber": "SN7407N",
					"customerLineItemNumber": "1",
					"customerPartNumber": "TILMNOP",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 2000,
					"customerAnticipatedUnitPrice": "0.30",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.339,
					"tiCurrencyCode": "USD",
					"messages": [
						{
							"code": "TI-TXT-051",
							"type": "INFO",
							"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": "2000",
							"requestedDeliveryDate": "2023-05-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 2000,
									"estimatedShipDate": "2024-07-24",
									"estimatedDeliveryDate": "2024-07-29",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000020",
					"tiPartNumber": "DRV8304SRHAR",
					"customerLineItemNumber": "2",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 5000,
					"customerAnticipatedUnitPrice": "1.00",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 1.08,
					"tiCurrencyCode": "USD",
					"messages": [
						{
							"code": "TI-TXT-051",
							"type": "INFO",
							"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": "5000",
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 5000,
									"estimatedShipDate": "2024-07-24",
									"estimatedDeliveryDate": "2024-07-29",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000030",
					"tiPartNumber": "SN7407DR",
					"customerLineItemNumber": "3",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 7500,
					"customerAnticipatedUnitPrice": "0.22",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.266,
					"tiCurrencyCode": "USD",
					"messages": [
						{
							"code": "TI-TXT-051",
							"type": "INFO",
							"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": "7500",
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 7500,
									"estimatedShipDate": "2024-07-24",
									"estimatedDeliveryDate": "2024-07-29",
									"shippedQuantity": 0
								}
							]
						}
					]
				}
			]
		}
	]
}

Paso 7: Consultar los detalles del pedido

Mediante la API de recuperación de pedidos pendientes, puede acceder a los detalles del pedido con el número de pedido de compra del cliente o el número de pedido de TI.  Para obtener más información sobre los pedidos y los detalles disponibles, consulte la página de documentación de la API de pedidos pendientes.

Ejemplo de recuperación de datos del pedido mediante el número de pedido del cliente:

curl --request GET \
--url https://transact-pre.ti.com/v2/backlog/orders?customerPurchaseOrderNumber=TestPO-001' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

Ejemplo de detalles de recuperación mediante el número de pedido del proveedor: 

curl --request GET \
--url ' https://transact-pre.ti.com/v2/backlog/orders?orderNumber=1019611092' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

Ejemplo de respuesta:

{
	"orders": [
		{
			"orderNumber": "1019610866",
			"orderDate": "2023-04-03 13:44:58",
			"customerPurchaseOrderNumber": "TestPO-001",
			"orderStatus": "OPEN",
			"shipToAccountNumber": "183290",
			"lineItems": [
				{
					"tiLineItemNumber": "000010",
					"tiPartNumber": "SN7407N",
					"customerLineItemNumber": "1",
					"customerPartNumber": "TILMNOP",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 2000,
					"customerAnticipatedUnitPrice": "0.30",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 2000,
							"requestedDeliveryDate": "2023-05-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 2000,
									"estimatedShipDate": "2024-07-22",
									"estimatedDeliveryDate": "2024-07-22",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000020",
					"tiPartNumber": "DRV8304SRHAR",
					"customerLineItemNumber": "2",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 5000,
					"customerAnticipatedUnitPrice": "1.00",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 5000,
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 5000,
									"estimatedShipDate": "2024-07-22",
									"estimatedDeliveryDate": "2024-07-22",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000030",
					"tiPartNumber": "SN7407DR",
					"customerLineItemNumber": "3",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 7500,
					"customerAnticipatedUnitPrice": "0.22",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 7500,
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 7500,
									"estimatedShipDate": "2024-04-08",
									"estimatedDeliveryDate": "2024-04-08",
									"shippedQuantity": 0
								}
							]
						}
					]
				}
			]
		},
		{
			"orderNumber": "1019620643",
			"orderDate": "2023-04-03 13:44:58",
			"customerPurchaseOrderNumber": "TestPO-001",
			"orderStatus": "OPEN",
			"shipToAccountNumber": "183290",
			"lineItems": [
				{
					"tiLineItemNumber": "000010",
					"tiPartNumber": "SN7407N",
					"customerLineItemNumber": "1",
					"customerPartNumber": "TILMNOP",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 2000,
					"customerAnticipatedUnitPrice": "0.30",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 2000,
							"requestedDeliveryDate": "2023-05-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 2000,
									"estimatedShipDate": "2024-07-22",
									"estimatedDeliveryDate": "2024-07-22",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000020",
					"tiPartNumber": "DRV8304SRHAR",
					"customerLineItemNumber": "2",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 5000,
					"customerAnticipatedUnitPrice": "1.00",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 5000,
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 5000,
									"estimatedShipDate": "2024-07-22",
									"estimatedDeliveryDate": "2024-07-22",
									"shippedQuantity": 0
								}
							]
						}
					]
				},
				{
					"tiLineItemNumber": "000030",
					"tiPartNumber": "SN7407DR",
					"customerLineItemNumber": "3",
					"customerPartNumber": "TIABCDEF",
					"status": "Not Delivered",
					"changeRequestWindow": "STD",
					"tiTotalOrderItemQuantity": 7500,
					"customerAnticipatedUnitPrice": "0.22",
					"customerCurrencyCode": "USD",
					"tiUnitPrice": 0.00,
					"tiCurrencyCode": "JPY",
					"messages": [
						{
							"code": "TI-TXT-005",
							"type": "INFO",
							"message": "Pricing could not be determined"
						},
						{
							"code": "TI-TXT-077",
							"type": "INFO",
							"message": "Customer Request Date is not the same as Estimated Delivery Date"
						}
					],
					"schedules": [
						{
							"requestedQuantity": 7500,
							"requestedDeliveryDate": "2023-06-01",
							"confirmations": [
								{
									"tiScheduleLineNumber": "0002",
									"scheduledQuantity": 7500,
									"estimatedShipDate": "2024-04-08",
									"estimatedDeliveryDate": "2024-04-08",
									"shippedQuantity": 0
								}
							]
						}
					]
				}
			]
		}
	]
}

Paso 8: Aprenda a cambiar un pedido 

Los campos de datos clave del pedido en la carga útil de la solicitud de cambio de pedido deben coincidir exactamente con la solicitud de pedido original. Entre estos campos se incluyen:

  • customerPurchaseOrderNumber
  • customerLineItemNumber
  • tiPartNumber

Póngase en contacto con el servicio de soporte de la API para que le ayude a probar la API de órdenes de cambio con su código de prueba de la API.

Ejemplo de solicitud de pedido de prueba:

{
	"order": {
		"customerPurchaseOrderNumber": "TestPO-230401-01",
		"shipToAccountNumber": "111111",
		"endCustomerCompanyName": "Company B",
		"lineItems": [
			{
				"customerLineItemNumber": "1",
				"tiPartNumber": "SN7407N",
				"customerPartNumber": "TILMNOP",
				"customerAnticipatedUnitPrice": 0.30,
				"customerCurrencyCode": "USD",
				"schedules": [
					{
						"requestedQuantity": 2000,
						"requestedDeliveryDate": "2023-05-01"
					}
				]
			}
		]
	}
}

Pruebe cualquiera de los siguientes escenarios de cambio de pedido con la URL de cambios en los pedidos de pruebas pendientes: https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (preproducción)

  1. Cambio de fecha de solicitud del cliente: establezca CustomerItemChangeIndicator en "U" y modifique CustomerRequestedDate según sea necesario.
  2. Cambio de la cantidad solicitada por el cliente: establezca CustomerItemChangeIndicator en "U" y modifique CustomerRequestedQuantity según sea necesario.
  3. Precio unitario esperado por el cliente (+/-)  establezca CustomerItemChangeIndicator en "U" y modifique CustomerExpectedUnitPrice según sea necesario

Ejemplo modificado de solicitud de cambio de pedido:

curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"order": {
		"customerPurchaseOrderNumber": "TestPO-230401-01",
		"shipToAccountNumber": "111111",
		"endCustomerCompanyName": "Company B",
		"lineItems": [
			{
				"customerLineItemNumber": "1",
				"lineItemChangeIndicator": "U",
				"tiPartNumber": "SN7407N",
				"customerPartNumber": "TILMNOP",
				"customerAnticipatedUnitPrice": 0.30,
				"customerCurrencyCode": "USD",
				"schedules": [
					{
						"requestedQuantity": 2000,
						"requestedDeliveryDate": "2023-06-15"
					}
				]
			}
		]
	}
}
DATA

Cómo anular un pedido con la URL de cambios en los pedidos de pruebas pendientes: https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (preproducción)

  1.  Escenario de prueba de cancelación de pedido: para cancelar el pedido completo, el indicador CustomerItemChangeIndicator debe tener el valor "X" para todos los artículos (1-n) del pedido. Para cancelar artículos individuales, solo enumere esos artículos con el indicador CustomerItemChangeIndicator establecido en “X” y elimine todos los demás artículos que deben seguir siendo parte del pedido.

Ejemplo modificado de solicitud de cancelación de cambio de pedido:

curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"order": {
		"customerPurchaseOrderNumber": "TestPO-230401-01",
		"shipToAccountNumber": "111111",
		"endCustomerCompanyName": "Company B",
		"lineItems": [
			{
				"customerLineItemNumber": "1",
				"lineItemChangeIndicator": "X",
				"tiPartNumber": "SN7407N",
				"customerPartNumber": "TILMNOP",
				"customerAnticipatedUnitPrice": 0.30,
				"customerCurrencyCode": "USD",
				"schedules": [
					{
						"requestedQuantity": 2000,
						"requestedDeliveryDate": "2023-06-15"
					}
				]
			}
		]
	}
}
DATA

Paso 9: Aprenda a recuperar el seguimiento de envíos

Después de embalar su pedido, cuando esté listo para enviarse, TI genera la información de seguimiento del envío a través de la API de notificaciones de avisos anticipados de embarque (ASN). La respuesta incluye información detallada sobre el envío, como el número de seguimiento de este, la información del transportista y las facturas comerciales. La API está disponible en implementaciones automáticas o de recuperación. Póngase en contacto con el servicio de soporte de la API para recibir más instrucciones para probar el ASN con su código de prueba de la API.

Ejemplo de solicitud de recuperación:

curl --request GET \
--url https://transact-pre.ti.com/v2/backlog/advanced-shipment-notices?orderNumber=1111111111111' \
--header 'Authorization: Bearer {access_token}' \

Ejemplo de respuesta:

{
	"orderNumber": "1111111111111",
	"data": {
		"consolidatedInformation": [
			{
				"estimatedDateOfArrival": "2023-03-28",
				"goodsIssueDate": "2023-03-23",
				"numberOfPallet": "1",
				"grossWeight": "1.200",
				"grossWeightUnitOfMeasure": "KG",
				"numberOfPieces": "1",
				"netWeight": "8.100",
				"netWeightUnitOfMeasure": "KG",
				"carrierShipmentMasterTrackingNumber": "30000001999999",
				"shippingDate": "2023-03-23",
				"shippingPoint": "9920",
				"shippingCondition": "EF",
				"modeOfTransport": "05",
				"buyerCode": "999999",
				"shipTrackReference": "30000001199999",
				"wayBillNumberList": [
					{
						"wayBillNumber": "0423599999",
						"creationDate": "2023-03-23",
						"creationTime": "13:20:27"
					}
				],
				"commercialInvoiceList": [
					{
						"commercialInvoiceNumber": "54901999999",
						"invoiceDate": "2023-03-23",
						"invoiceTime": "13:21:43",
						"incotermCode": "FCA",
						"incotermDescription": "BUYER'S FORWARDER",
						"invoiceValue": "5000.000",
						"currency": "USD"
					}
				],
				"shipToDetails": {
					"plantIdentifier": "0000111111",
					"companyName": "ACME WIDGET SOLUTIONS INC",
					"address1": "1234 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": "TX",
					"postalCode": "99999-9999",
					"countryCode": "US",
					"companyNameAdditionalDetail": "ACME SHIPPING DEPOT ORGANIZATIONS"
				},
				"shipFromDetails": {
					"plantIdentifier": "9990",
					"companyName": "Texas Instruments Southeast Asia PL",
					"contactName": "GEROGE",
					"address1": "No. 56, ACORN Avenue",
					"city": "Singapore",
					"stateRegion": "SGP",
					"postalCode": "99999",
					"countryCode": "SG"
				},
				"crossDockDetails": {
					"plantIdentifier": "0000999999"
				},
				"manifestIdentifierList": {
					"manifestIdentifier": "009999999"
				},
				"bookingOrderDetails": [
					{
						"customerPurchaseOrderNumber": "ABCD_9of10",
						"purchaseOrderDate": "2023-01-13",
						"passThrus": [
							{
								"orderNumber": "1019609117",
								"passThru1": "ZHIC*00001*BP=0000111111",
								"passThru2": "ZHIC*00002*AG=111111",
								"passThru3": "ZHIC*00003*WE=111111"
							}
						],
						"packageDetails": [
							{
								"packageHandlingUnitNumber": "0046677747",
								"packageContainerVolume": "2.116",
								"packageContainerVolumeUnitOfMeasure": "CDM",
								"packageLength": "23.000",
								"packageWidth": "23.000",
								"packageHeight": "4.000",
								"unitOfMeasure": "CM",
								"trackingNumber": "30000001144761",
								"numberOfLineItems": "1",
								"netWeight": "8.100",
								"grossWeight": "1.199",
								"weightUnitOfMeasure": "KG",
								"itemDetails": [
									{
										"tiPartNumber": "SN74LS00N",
										"tiPartDescription": "QUAD 2-INPUT NAND GATE",
										"deliveryLineItemNumber": "000010",
										"deliveryDocumentNumber": "0620549184",
										"orderNumber": "1019609117",
										"lineItemNumber": "000010",
										"customerPurchaseOrderNumber": "ABCD_9of10",
										"customerLineItemNumber": "1",
										"purchaseOrderDate": "2023-01-13",
										"numberOfUnitsShipped": "0000005000",
										"baseUnitOfMeasure": "EA",
										"grossWeight": "1.199",
										"netWeight": "8.100",
										"weightUnitOfMeasure": "KG",
										"commercialInvoiceNumber": "5490149743",
										"commercialInvoiceItem": "000001",
										"commercialInvoiceUnitprice": "1.000000",
										"commercialInvoiceValue": "5000.000000",
										"commercialInvoiceCurrency": "USD",
										"countryOfOriginCode": "CN",
										"countryOfOriginDescription": "China",
										"assemblyCountryOfOriginCode3Character": "CHN",
										"assemblyCountryOfOriginCode2Character": "CN",
										"assemblyCountryOfOriginDescription": "China",
										"harmonizedTariffScheduleExportCode": "85423900",
										"harmonizedTariffScheduleExportDescription": "OTHER ELECTRONIC INTEGRATED CIRCUITS (MIL)",
										"harmonizedTariffScheduleImportCode": "8542390001",
										"harmonizedTariffScheduleImportDescription": "Electronic integrated circuits Other",
										"confirmDate": "2023-03-23",
										"orderType": "TA",
										"deliveryLineItemTotalQuantity": "5000.000",
										"deliveryLineItemTotalQuantityUnitOfMeasure": "EA",
										"goodsIssueDate": "2023-03-23",
										"goodsIssueTime": "13:21:48",
										"shipTrackCodeList": [
											{
												"shipTrackCode": "0444872ZFV",
												"chipCountryOfOriginCode3Character": "CHN",
												"chipCountryOfOriginCode2Character": "CN",
												"chipCountryOfOriginDescription": "China",
												"shipTrackCodeQuantity": "0000005000",
												"batchNumber": "1100044LGH",
												"shipDate": "2023-03-23",
												"dateCode": "2303+5"
											}
										]
									}
								]
							}
						]
					}
				]
			}
		]
	}
}

Paso 10: Aprenda a recuperar documentos financieros

La API de documentos financieros proporciona información de los pagos. Para recuperar una factura mediante la API de documentos financieros, se requiere uno de los siguientes datos: número de pedido, número de documento financiero, número de entrega o número de pedido del cliente.  Cuando se consulta por intervalo de fechas, las fechas de inicio y fin se refieren a la fecha de creación de la factura. Los documentos financieros estarán disponibles después de que TI procese el envío.  La API está disponible en implementaciones automáticas o de recuperación.

Para recuperar un PDF, consulte la documentación para ver las opciones de configuración.

Póngase en contacto con el soporte de API para obtener más instrucciones para probar la recuperación de API de documento financiero con su código de prueba de API.

Ejemplo:

curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/financial-documents?orderNumber=1111111111111' \
--header 'Authorization: Bearer {access_token}' \

Ejemplo de respuesta:

{
	"orderNumber": "1111111111111",
	"totalNumberOfDocuments": "2",
	"documents": [
		{
			"documentType": "INVOICE",
			"financialDocumentNumber": "1111111111111",
			"documentCreatedDate": "2023-03-23",
			"status": "CLEARED",
			"currencyCode": "USD",
			"customerPurchaseOrderNumber": "PO_10of10",
			"customerReferenceNumber": "1111111111111",
			"grossWeight": "8100.000",
			"netWeight": "8100.000",
			"weightUnit": "GRM",
			"carrier": "DHL WORLDWIDE EXPRESS",
			"documentValue": {
				"totalAmount": "5,312.50"
			},
			"salesOrder": {
				"orderNumber": "1111111111111",
				"lineItemNumber": "000000",
				"customerPurchaseOrderNumber": "PO_10of10",
				"purchaseOrderDate": "2023-01-13"
			},
			"paymentTerms": {
				"incoterms1": "FCA",
				"incoterms2": "BUYER'S FORWARDER",
				"termsOfDelivery": "FCA BUYER'S FORWARDER",
				"termsOfPayment": "Net 45 Days from Invoice Date",
				"paymentTermsText": [
					{
						"SupplierPaymentTermsText": "Up to 05/07/2023 without deduction"
					}
				]
			},
			"delivery": {
				"deliveryNumber": "1111111111111",
				"deliveryLineItemNumber": "000000",
				"deliveryDate": "2023-04-02",
				"goodsMovementDate": "2023-03-23"
			},
			"waybill": {
				"waybillNumber": "1111111111111",
				"containerIdentifier": "30000001144761",
				"numberOfBoxes": "1"
			},
			"partners": [
				{
					"partnerTypeDescription": "Sender",
					"name1": "Texas Instruments Incorporated",
					"name2": "Semiconductor",
					"streetAddress": "12500 TI Boulevard",
					"city": "Dallas",
					"stateRegion": "TX",
					"postalCode": "75243",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Remit To",
					"name1": "For ACH Transfer send to:",
					"name2": "Texas Instruments, c/o Bank of TI",
					"name3": "Bank Acct 12345987",
					"name4": "ABA 111111111",
					"city": "DALLAS",
					"stateRegion": "TX",
					"postalCode": "75202",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Sold-to Party",
					"partnerIdentifier": "1111111",
					"name1": "ACME WIDGETS INC",
					"name2": " ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "123 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": "TX",
					"postalCode": "12345-1234",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Bill-to Party",
					"name1": "ACME WIDGETS INC",
					"name2": " ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "123 MAIN ST",
					"city": "ELDARAOD",
					"stateRegion": "TX",
					"postalCode": "12345-1234",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Ship-to Party",
					"partnerIdentifier": "11111",
					"name1": "ACME WIDGETS INC",
					"name2": " ACME WIDGETS SHIPIPING DEPOT ORGANIZATIONS",
					"streetAddress": "123 MAIN ST",
					"city": "ELDAROAD",
					"stateRegion": "TX",
					"postalCode": "12345-1234",
					"countryCode": "US"
				}
			],
			"items": [
				{
					"lineItemNumber": "000010",
					"tiPartNumber": "SN74LS00N",
					"tiPartDescription": "QUAD 2-INPUT NAND GATE",
					"quantity": "5000.000",
					"unitPrice": "1.00",
					"netPrice": "5,000.00",
					"grossWeight": "8100.000",
					"netWeight": "8100.000",
					"commercialInvoiceNumber": "5490149745",
					"salesOrder": {
						"orderNumber": "1111111111111",
						"lineItemNumber": "000010",
						"customerPurchaseOrderNumber": "PO_10of10",
						"customerPurchaseOrderLineItemNumber": "1",
						"purchaseOrderDate": "2023-01-13"
					},
					"delivery": {
						"deliveryNumber": "0620549185",
						"deliveryLineItemNumber": "000010",
						"deliveryDate": "2023-04-02",
						"goodsMovementDate": "2023-03-23",
						"grossWeight": "8100.000",
						"netWeight": "8100.000"
					},
					"itemVAT": [
						{
							"taxIndicator": "O1",
							"taxRate": "6.250",
							"taxAmount": "312.50",
							"taxJurisdiction": "USIL0000000000"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012400000"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						}
					]
				}
			]
		},
		{
			"documentType": "CREDIT NOTE",
			"financialDocumentNumber": "11111111111",
			"documentCreatedDate": "2023-03-29",
			"status": "CLEARED",
			"currencyCode": "USD",
			"customerPurchaseOrderNumber": "PO_10of10",
			"customerReferenceNumber": "11111111",
			"grossWeight": "8100.000",
			"netWeight": "8100.000",
			"weightUnit": "GRM",
			"carrier": "SEE CARRIER REFERENCE TABLE",
			"documentValue": {
				"totalAmount": "531.25"
			},
			"salesOrder": {
				"orderNumber": "1111111111",
				"lineItemNumber": "000000",
				"customerPurchaseOrderNumber": "PO_10of10"
			},
			"paymentTerms": {
				"incoterms1": "FCA",
				"incoterms2": "TI's POINT OF SHIPMENT",
				"termsOfDelivery": "FCA TI's POINT OF SHIPMENT",
				"termsOfPayment": "Net 45 Days from Invoice Date",
				"paymentTermsText": [
					{
						"SupplierPaymentTermsText": "Up to 05/13/2023 without deduction"
					}
				]
			},
			"delivery": {
				"deliveryLineItemNumber": "000000"
			},
			"partners": [
				{
					"partnerTypeDescription": "Sender",
					"name1": "Texas Instruments Incorporated",
					"name2": "Semiconductor",
					"streetAddress": "12500 TI Boulevard",
					"city": "Dallas",
					"stateRegion": "TX",
					"postalCode": "75243",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Remit To",
					"name1": "For ACH Transfer send to:",
					"name2": "Texas Instruments, c/o Bank of TI",
					"name3": "Bank Acct 123456879",
					"name4": "ABA 111111111",
					"city": "DALLAS",
					"stateRegion": "TX",
					"postalCode": "75202",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Sold-to Party",
					"partnerIdentifier": "111111",
					"name1": "ACME WIDGETS INC",
					"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "1234 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": “TX”,
					"postalCode": "12345-1234",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Bill-to Party",
					"name1": "ACME WIDGETS INC",
					"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "1234 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": “TX”,
					"postalCode": "12345-1234",
					"countryCode": "US"
				},
				{
					"partnerTypeDescription": "Ship-to Party",
					"partnerIdentifier": "111111",
					"name1": "ACME WIDGETS INC",
					"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
					"streetAddress": "1234 MAIN ST",
					"city": "ELDARADO",
					"stateRegion": “TX”,
					"postalCode": "12345-1234",
					"countryCode": "US"
				}
			],
			"items": [
				{
					"lineItemNumber": "000010",
					"tiPartNumber": "SN74LS00N",
					"tiPartDescription": "QUAD 2-INPUT NAND GATE",
					"quantity": "5000.000",
					"unitPrice": "0.10",
					"netPrice": "500.00",
					"grossWeight": "8100.000",
					"netWeight": "8100.000",
					"salesOrder": {
						"orderNumber": "1111111111",
						"lineItemNumber": "000010",
						"customerPurchaseOrderNumber": "PO_10of10",
						"customerPurchaseOrderLineItemNumber": "00010"
					},
					"delivery": {
						"deliveryLineItemNumber": "000000"
					},
					"itemVAT": [
						{
							"taxIndicator": "O1",
							"taxRate": "6.250",
							"taxAmount": "31.25",
							"taxJurisdiction": "USIL0000000000"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012400000"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						},
						{
							"taxIndicator": "O1",
							"taxRate": "0.000",
							"taxAmount": "0.00",
							"taxJurisdiction": "USIL6012478340"
						}
					]
				}
			]
		}
	]
}

Paso 11: Crear aviso de remesa

El sistema del cliente puede llamar a la API de aviso de remesas para enviar información de remesas con el fin de crear un registro de aviso de remesas en el sistema empresarial de TI.

Cada solicitud debe contener secciones de encabezado y producto.  Las secciones de cabecera identifican el aviso de remesa del cliente y la información del código de moneda.  La sección de artículos puede contener uno o más registros detallados, con información específica sobre pagos y documentos financieros asociados. Para obtener más información, consulte la página API de avisos de remesas pendientes.

Ejemplo de solicitud:

curl --request POST \
  --url 'https://transact-pre.ti.com/v2/backlog/remittance-advice' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'Content-Type: application/json' \
  --data-binary @- <<DATA
{
	"remittanceAdviceNumber": "CustomerRemit100",
	"currencyCode": "USD",
	"lineItems": [
		{
			"paymentAmount": "2000",
			"financialDocumentNumber": "1234567890"
		},
		{
			"paymentAmount": "200",
			"financialDocumentNumber": "234567890"
		}
	]
}
DATA

Ejemplo de respuesta:

{
	"supplierRemittanceAdviceIdentifier": "06CustomerRemit1",
	"remittanceAdviceNumber": "CustomerRemit100",
	"currencyCode": "USD",
	"message": [
		{
			"code": "TI-TXT-012013",
			"type": "SUCCESS",
			"message": "Remittance Advice 06CustomerRemit1 posted."
		}
	],
	"lineItems": [
		{
			"paymentAmount": "2000",
			"financialDocumentNumber": "1234567890"
		},
		{
			"paymentAmount": "200",
			"financialDocumentNumber": "234567890"
		}
	]
}

Paso 12: Dónde obtener soporte técnico

Para obtener soporte técnico, consulte el foro de soporte de diseño de TI E2E™ o publique su pregunta.