Sidebar - Backlog-V1

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. Obtener 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 de API de pedidos pendientes para pedidos, órdenes de cambio, cotizaciones y avisos de remesa. Estos códigos también aparecen en varios de los documentos salientes que se envían al cliente:
    1. El código de venta es la entidad de compra
    2. El código del destinatario de la factura es donde TI genera las facturas
    3. El código de pagador es desde donde se pagan las facturas
    4. El código de envío es adonde TI envía el producto
    5. 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 inicial de incorporación de cliente, le indicaremos en esta notificación por correo electrónico el país de nuestro banco para que lo utilice en la configuración del proveedor.

 

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

TI ha asegurado sus suites API con OAuth 2.0. Utilice su clave de API y palabra secreta para autenticarse. Después de la autorización, OAuth2 devuelve un token de acceso que se utiliza con las API del conjunto de aplicaciones que ha habilitado. Para obtener más detalles, consulte la página de Autenticació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 enviar una cotización para varias piezas y cantidades, y los clientes recibirán un número de cotización como referencia. Las respuestas a las cotizaciones suelen estar disponibles en un plazo de 24 horas. 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.ti.com/v1/quotes' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"SupplierSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"CustomerContactEmailAddress": "john-smith@test-customer123.com",
		"CustomerContactPhoneNumber": "888-888-8888",
		"CustomerEndCustomerIdentifier": "John Smith",
		"CustomerEndCustomerName": "Company XYZ",
		"CustomerEndCustomerCity": "Dallas",
		"CustomerEndCustomerCountry": "US",
		"CustomerEndCustomerPostalCode": "75208",
		"CustomerIntermediateCustomerName": "Company ABC",
		"CustomerIntermediateCustomerCity": "",
		"CustomerIntermediateCustomerCountry": "",
		"CustomerIntermediateCustomerPostalCode": "",
		"CustomerEndCustomerWebsite": "https://www.companyxyz.com",
		"LineItems": [
			{
				"CustomerQuoteLineItemNumber": 1,
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"CustomerCompetingSupplierName": "Competitor N",
				"CustomerItemComments": "Costdown Quote",
				"CustomerCompetingSupplierMaterial": "SNKLLPO23",
				"CustomerCompetingSupplierUnitPrice": 1.43,
				"CustomerCompetingSupplierCurrency": "USD"
			}
		]
	}
}
DATA

Ejemplo de respuesta al crear una cotización:

{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"SupplierEndCustomerName": "Company XYZ",
		"SupplierEndCustomerWebSite": "https://companyxyz.com",
		"SupplierQuoteStatus": "Accept",
		"SupplierSoldToIdentifier": 114207,
		"SupplierQuoteValidFromDate": "2021-09-15T00:00:00Z",
		"SupplierQuoteValidToDate": "2022-03-14T00:00:00Z",
		"LineItems": [
			{
				"CustomerQuoteLineItemNumber": 1,
				"SupplierQuoteItemStatus": "Pending",
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"CustomerCompetingSupplierName": "Competitor N",
				"SupplierQuoteItemComments": "Costdown Quote",
				"Description": "Quote created with number: 26679695"
			}
		]
	}
}

Las respuestas a las cotizaciones suelen estar disponibles de 30 minutos a 24 horas después de enviar una cotización. SupplierQuoteStatus indica si se acepta, rechaza o modifica una cotización. "SupplierQuoteItemStatus" indica si un producto de línea está pendiente, en oferta o sin oferta.

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

curl --request GET \   
--url 'https://transact.ti.com/v1/quotes/{customerQuoteNumber}' \
--header 'Authorization: Bearer {access_token}' \

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

{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"CustomerEndCustomerName": "Company XYZ",
		"CustomerEndCustomerWebsite": "https://companyxyz.com",
		"SupplierEndCustomerName": "XYZ CORPORATION",
		"SupplierEndCustomerWebSite": "https://companyxyz.com",
		"SupplierQuoteStatus": "Accept",
		"SupplierSoldToIdentifier": "114207",
		"SupplierSoldToName": "YOUR COMPANY NAME",
		"SupplierQuoteValidFromDate": "2021-09-15T00:00:00Z",
		"SupplierQuoteValidToDate": "2022-03-14T00:00:00Z",
		"LineItems": [
			{
				"SupplierQuoteLineItemNumber": 10,
				"SupplierQuoteItemStatus": "Pending",
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"SupplierUnitPrice": 0,
				"SupplierUnitPriceCurrency": "USD",
				"CustomerCompetingSupplierName": "Competitor N",
				"SupplierQuoteItemComments": "Costdown Quote",
				"SupplierProductLeadTime": 35,
				"SupplierProductMinimumQuantity": 90,
				"SupplierProductNextQuantityIncrement": 90,
				"SupplierProductPackageType": "JEDEC TRAY (5+1)",
				"SupplierProductRestrictionOfHazardousSubstancesCompliant": "Y",
				"SupplierProductCancellationWindowWeeks": 5,
				"SupplierProductRescheduleWindowWeeks": 5,
				"SupplierNonCancellableNonReturnableProduct": false,
				"SupplierProductType": "STD",
				"SupplierProductMoistureLevel": "3",
				"SupplierProductExportControlClassificationNumber": "EAR99",
				"SupplierPaymentTerms": "Per Negotiated Terms"
			}
		]
	}
}

Paso 6: Crear un pedido de prueba

Los pedidos de prueba son simulados en nuestro entorno de prueba de preproducción y se han diseñado específicamente para 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 para crear un pedido de prueba pendiente: https://transact-pre.ti.com/v1/orders/create (preproducción)  

  1. Para realizar un pedido (de prueba o de producción), el cliente debe contar con la autorización, tener configurados los ajustes y haber completado 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

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

curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/create' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "Order": {
    "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
    "CustomerPurchaseOrderDate": "YYYY-MM-DD",
    "CustomerSoldToIdentifier": "111111",
    "CustomerShipToIdentifier": "111111",
    "CustomerEndCustomerIdentifier": "",
    "
    "LineItems": [
      {
        "CustomerPurchaseOrderLineItemNumber": "1",
        "SupplierProductIdentifier": "SN74LS00N",
        "CustomerProductIdentifier": "CPN-XXX",
        "CustomerExpectedUnitPrice": "0.987",
        "Schedules": [
          {
            "CustomerRequestedQuantity": "2000",
            "CustomerRequestedDate": "2023-06-15"
          },
          {
            "CustomerRequestedQuantity": "3000",
            "CustomerRequestedDate": "2023-07-15"
          }
        ]
      },
      {
        "CustomerPurchaseOrderLineItemNumber": "2",
        "SupplierProductIdentifier": "SN74LS00N",
        "CustomerProductIdentifier": "",
        "CustomerExpectedUnitPrice": "1",
        "Schedules": [
          {
            "CustomerRequestedQuantity": "4000",
            "CustomerRequestedDate": "2023-08-01"
          }
        ]
      }
    ]
  }
}

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

{
  "Orders": [
    {
      "AsOfDateTime": "2023-02-24 17:02:11",
      "SupplierOrderStatus": "ACCEPT",
      "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
      "CustomerSoldToIdentifier": "111111",
      "CustomerShipToIdentifier": "111111",
      "LineItems": [
        {
          "CustomerPurchaseOrderLineItemNumber": "1",
          "SupplierProductIdentifier": "SN74LS00N",
          "CustomerExpectedUnitPrice": "0.987",
          "Schedules": [
            {
              "CustomerRequestedQuantity": 2000,
              "CustomerRequestedDate": "2023-06-15"
            },
            {
              "CustomerRequestedQuantity": 3000,
              "CustomerRequestedDate": "2023-07-15"
            }
          ]
        },
        {
          "CustomerPurchaseOrderLineItemNumber": "2",
          "SupplierProductIdentifier": "SN74LS00N",
          "CustomerExpectedUnitPrice": 1,
          "Schedules": [
            {
              "CustomerRequestedQuantity": 4000,
              "CustomerRequestedDate": "2023-08-01"
            }
          ]
        }
      ]
    }
  ]
}

Cuando esté listo para realizar un pedido pendiente en producción, revise todos los parámetros que desea enviar en la carga útil de la solicitud y utilice las versiones de producción del pedido de autenticación y del pedido pendiente para crear la URL de la API: https://transact.ti.com/v1/oauth and https://transact.ti.com/v1/orders/create.

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.

 

Paso 7:  Consultar los detalles del pedido

Mediante la API de recuperación de pedidos pendientes, puede acceder a los detalles del pedido mediante el número de orden de compra del cliente o el número de pedido del proveedor.

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

curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

{
  "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115"
  }​

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

​
curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

{
    "SupplierOrderIdentifier": "1000004607"
}

​

Ejemplo de respuesta:

{
  "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
  "SupplierOrderIdentifier": "1000004607",
  "Orders": [
    {
      "AsOfDateTime": "2023-03-27 20:57:06",
      "SupplierOrderIdentifier": "1000000000",
      "SupplierOrderStatus": "OPEN",
      "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
      "CustomerSoldToIdentifier": "111111",
      "CustomerShipToIdentifier": "111111",
      "LineItems": [
        {
          "SupplierOrderLineItemNumber": "000010",
          "CustomerPurchaseOrderLineItemNumber": "1",
          "SupplierOrderItemStatus": "Not Delivered",
          "SupplierChangeOrderWindow": "NON",
          "SupplierProductIdentifier": "SN74LS00N",
          "SupplierTotalOrderItemQuantity": 5000,
          "CustomerExpectedUnitPrice": "0.152",
          "SupplierUnitPrice": 1,
          "CustomerCertificateOfConformance": "YES",
          "LineItemMessages": [
            {
              "Code": "TI-TXT-051",
              "Type": "INFO",
              "Message": "Customer expected price mismatch with TI price"
            },
            {
              "Code": "TI-TXT-089",
              "Type": "INFO",
              "Message": "Item quantity does not match rated quantity; Rating has not been applied"
            }
          ],
           "Schedules": [
            {
              "CustomerRequestedQuantity": 2000,
              "CustomerRequestedDate": "2023-06-15",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0005",
                  "SupplierConfirmedQuantity": 2000,
                  "CustomerRequestedShipDate": "2023-06-12",
                  "SupplierEstimatedShipDate": "2023-06-12",
                  "SupplierEstimatedDeliveryDate": "2023-06-15",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            },
            {
              "CustomerRequestedQuantity": 3000,
              "CustomerRequestedDate": "2020-07-15",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0006",
                  "SupplierConfirmedQuantity": 3000,
                  "CustomerRequestedShipDate": "2023-07-10",
                  "SupplierEstimatedShipDate": "2023-07-10",
                  "SupplierEstimatedDeliveryDate": "2023-07-15",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            }
          ]
        },
        {
          "SupplierOrderLineItemNumber": "000020",
          "CustomerPurchaseOrderLineItemNumber": "2",
          "SupplierOrderItemStatus": "Not Delivered",
          "SupplierChangeOrderWindow": "NON",
          "SupplierProductIdentifier": "SN74LS00N",
          "SupplierTotalOrderItemQuantity": 4000,
          "CustomerExpectedUnitPrice": "1.00",
          "SupplierUnitPrice": 1,
          "Schedules": [
            {
              "CustomerRequestedQuantity": 4000,
              "CustomerRequestedDate": "2023-08-01",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0002",
                  "SupplierConfirmedQuantity": 4000,
                  "CustomerRequestedShipDate": "2023-07-29",
                  "SupplierEstimatedShipDate": "2023-07-29",
                  "SupplierEstimatedDeliveryDate": "2023-08-01",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

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.

 

Paso 8: Aprenda a cambiar un pedido 

El primer paso para solicitar cambios en un pedido es verificar que haya creado un pedido de prueba.

Los parámetros de datos que se indican a continuación proceden de la carga útil de la solicitud de creación de pedido y especifican el número de pedido de prueba creado, la fecha de creación del pedido, el estado del pedido y el número de pedido del cliente que identifica este pedido.

  •  AsOfDateTime "2023-01-30 18:11:04"
  •  SupplierOrderIdentifier "1111111111"
  •  SupplierOrderStatus "OPEN"
  •  CustomerPurchaseOrderIdentifier "PO-Order1"

Los campos de datos del pedido en la carga útil de la solicitud de cambio de pedido deben coincidir exactamente con la solicitud del pedido original.

Ejemplo de solicitud de pedido de prueba:

  {
	"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order1",
		"CustomerPurchaseOrderDate": "2022-12-01",
		"CustomerSoldToIdentifier": "111111",
		"CustomerShipToIdentifier": "111111",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

Pruebe cualquiera de los siguientes escenarios para el cambio de pedido utilizando la url de cambio de órdenes de prueba de pedidos pendientes: https://transact-pre.ti.com/v1/orders/change (preproducción)  

  1. Cambio de fecha de solicitud del cliente - establecer CustomerItemChangeIndicator en “U” y modificar CustomerRequestedDate  según sea necesario. 
  2. Cambio de cantidad de solicitud del cliente - establecer CustomerItemChangeIndicator en “U” y modificar CustomerRequestedQuanity  según sea necesario.
  3. Precio unitario esperado por el cliente (+/-)  establecer CustomerItemChangeIndicator en “U” y modificar CustomerExpectedUnitPrice  según sea necesario


Ejemplo modificado de solicitud de cambio de pedido:

"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order1",
		"CustomerPurchaseOrderDate": "2022-12-01",
		"CustomerSoldToIdentifier": "167435",
		"CustomerShipToIdentifier": "167435",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"CustomerItemChangeIndicator": "U",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

Cómo cancelar un pedido utilizando la url de cambio de órdenes de prueba de pedidos pendientes: https://transact-pre.ti.com/v1/orders/change (pre-producción)  con el siguiente indicador de parámetro para cada artículo de línea.

 4. Escenario de prueba de cancelación de pedido - Para cancelar el pedido completo, el indicador CustomerItemChangeIndicator debe establecerse en “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:

{
	"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order2",
		"CustomerPurchaseOrderDate": "2023-01-01",
		"CustomerSoldToIdentifier": "111111",
		"CustomerShipToIdentifier": "111111",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"CustomerItemChangeIndicator": "X",
				"SupplierProductIdentifier": "SN74LVC139",
				"CustomerProductIdentifier": "SN74LVC139",
				"CustomerExpectedUnitPrice": 1.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
		      		
       "LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "2",
				"CustomerItemChangeIndicator": "X",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

Póngase en contacto con el soporte de API para obtener ayuda para probar la API de cambio de pedidos con su código de prueba de API.

 

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 instantáneas o de recuperación. 

Ejemplo de solicitud de recuperación:

curl --request POST \
--url 'https://transact-pre.ti.com/v1/advance-ship-notices/retrieve/?SupplierOrderIdentifier=123456789&
CustomerSoldToIdentifier=ABC123456&RequestCommercialInvoicePDF=X&RequestWaybillPDF=X' \
--header 'Authorization: Bearer {access_token}'

Ejemplo de respuesta:

{
  "CustomerSoldToIdentifier": "ABCDEF",
  "SupplierOrderIdentifier": "1234567890",
  "CustomerPurchaseOrderIdentifier": "T1234567",
  "SupplierWayBillIdentifier": "5678901234",
  "RequestCommercialInvoicePDF": "X",
  "RequestWaybillPDF": "X",
  "Data": {
    "ConsolidatedInformation": [
      {
        "ShipmentEstimatedDateOfArrival": {},
        "ShipmentGoodsIssueDate": {},
        "ShipmentNumberOfPallet": "1",
        "ShipmentGrossWeight": "2.450",
        "ShipmentGrossWeightUnitOfMeasure": "KG",
        "ShipmentNumberOfPieces": "2",
        "ShipmentNetWeight": "0.264",
        "ShipmentNetWeightUnitOfMeasure": "KG",
        "ShipmentServiceLevelCode": "ABC",
        "ShipmentProductDescription": "ABC DEF GHI",
        "CarrierShipmentMasterTrackingNumber": "123456",
        "CarrierShipmentBoxTrackingNumber": "CUSTOMER XLR8",
        "SupplierShippingDate": {},
        "SupplierShippingPoint": "1808",
        "SupplierShippingCondition": "EG",
        "CustomerSoldToIdentifier": "0000123456",
        "SpecialProcessingIndicator": "string",
        "ModeOfTransport": "05",
        "CustomerBuyerCode": "12345",
        "CustomerShipperVendorCode": "ABCDEFG",
        "SupplierShipTrackReference": "123456789012",
        "SupplierSoldToPartyName": "CUSTOMER CORPORATION",
        "ShipmentInternalTransactionNumberList": [
          {
            "ShipmentInternalTransactionNumber": "1234"
          }
        ],
        "ForwardingAgentDetails": {
          "ForwarderCompanyName": "XYZ",
          "ForwarderStandardCarrierAccessCode": "ABCD",
          "SupplierCarrierIdentifier": "12345",
          "SupplierCarrierTrackingWebSite": "https://www.carrierxyz.com"
        },
        "SupplierWayBillNumberList": [
          {
            "SupplierWayBillIdentifier": "5678901234",
            "SupplierWayBillCreationDate": {},
            "SupplierWayBillCreationTime": "09:15:08",
            "SupplierWaybillPDF": "string"
          }
        ],
        "SupplierCommercialInvoicelist": [
          {
            "SupplierCommercialInvoiceIdentifier": "987654321",
            "SupplierCommercialInvoiceDate": {},
            "SupplierCommercialInvoiceTime": "22:32:40",
            "SupplierIncotermCode": "DDP",
            "SupplierIncotermDescription": "Buyers Dock",
            "SupplierCommercialInvoiceValue": "100.100",
            "SupplierCommercialInvoiceCurrency": "USD",
            "SupplierCommercialInvoicePDF": "string"
          }
        ],
        "ShipToDetails": {
          "CustomerShipToPlantIdentifier": "00001234",
          "CustomerShipToCompanyName": "XYZ",
          "CustomerShipToContactName": "010-234-2010",
          "CustomerShipToAddress1": "123 Main St",
          "CustomerShipToAddress2": "ABC",
          "CustomerShipToCity": "Fort Worth",
          "CustomerShipToState": "TX",
          "CustomerShipToZipCode": "12345-1234",
          "CustomerShipToCountry": "US",
          "CustomerShipToCompanyNameAdditionalDetail": "ABCD"
        },
        "ShipFromDetails": {
          "SupplierShipFromPlantIdentifier": "00001234",
          "SupplierShipFromCompanyName": "Texas Instruments",
          "SupplierShipFromContactName": "010-234-2010",
          "SupplierShipFromAddress1": "13601 Independence Parkway",
          "SupplierShipFromAddress2": "ABC",
          "SupplierShipFromCity": "Fort Worth",
          "SupplierShipFromState": "TX",
          "SupplierShipFromZipCode": "12345-1234",
          "SupplierShipFromCountry": "US",
          "SupplierShipFromEmailAddress": "test@test.com",
          "SupplierShipFromPhoneNumber": "010-101-2031"
        },
        "SupplierCrossDockDetails": {
          "SupplierCrossDockPlantIdentifier": "00001234",
          "SupplierCrossDockCompanyName": "XYZ",
          "SupplierCrossDockContactName": "010-234-2010",
          "SupplierCrossDockAddress1": "123 Main St",
          "SupplierCrossDockAddress2": "ABC",
          "SupplierCrossDockCity": "Fort Worth",
          "SupplierCrossDockState": "TX",
          "SupplierCrossDockZipCode": "12345-1234",
          "SupplierCrossDockCountry": "US"
        },
        "ImporterDetails": {
          "ImporterCompanyName": "XYZ",
          "ImporterContactName": "010-234-2010",
          "ImporterAddress1": "13601 Independence Parkway",
          "ImporterAddress2": "ABC",
          "ImporterCity": "Fort Worth",
          "ImporterState": "TX",
          "ImporterZipCode": "12345-1234",
          "ImporterCountry": "US"
        },
        "SupplierManifestIdentifierList": {
          "SupplierManifestIdentifier": "7890123456"
        },
        "BookingOrderDetails": [
          {
            "CustomerPurchaseOrderIdentifier": "T1234567",
            "CustomerPurchaseOrderDate": {},
            "PassThrus": [
              {
                "SupplierOrderIdentifier": "1234567890",
                "CustomerPassthru1": "ZREF*00001*URL=www.test.com",
                "CustomerPassthru2": "ZREF*00002*URL=www.test.com",
                "CustomerPassthru3": "ZREF*00003*URL=www.test.com",
                "CustomerPassthru4": "ZREF*00004*URL=www.test.com",
                "CustomerPassthru5": "ZREF*00005*URL=www.test.com",
                "CustomerPassthru6": "ZREF*00006*URL=www.test.com",
                "CustomerPassthru7": "ZREF*00007*URL=www.test.com",
                "CustomerPassthru8": "ZREF*00008*EML=test@test.com",
                "CustomerPassthru9": "ZREF*00009*URL=www.test.com",
                "CustomerPassthru10": "ZREF*00010*URL=www.test.com",
                "CustomerPassthru11": "ZREF*00011*URL=www.test.com",
                "CustomerPassthru12": "ZREF*00012*EML=test@test.com",
                "CustomerPassthru13": "ZREF*00013*URL=www.test.com",
                "CustomerPassthru14": "ZREF*00014*URL=www.test.com",
                "CustomerPassthru15": "ZREF*00015*URL=www.test.com"
              }
            ],
            "PackageDetails": [
              {
                "PackageHandlingUnitIdentifier": "1234567890",
                "PackageContainerVolume": "0.000",
                "PackageContainerVolumeUnitOfMeasure": "CDM",
                "PackageLength": "0.000",
                "PackageWidth": "0.000",
                "PackageHeight": "0.000",
                "PackageLWHUnitOfMeasure": "MM",
                "PackageTrackingNumber": "123456789012",
                "PackageNumberOfLineItems": "0",
                "PackageAlternateHandlingUnitIdentifier": "ABCDEFGH",
                "PackageNetWeight": "0.000",
                "PackageGrossWeight": "0.000",
                "PackageWeightUnitOfMeasure": "KG",
                "ItemDetails": [
                  {
                    "SupplierProductIdentifier": "TPS12345",
                    "CustomerProductIdentifier": "ABCDEFG",
                    "SupplierProductDescription": "TPS12345 description",
                    "SupplierDeliveryLineItemNumber": "000010",
                    "SupplierDeliveryIdentifier": "0123456789",
                    "SupplierOrderIdentifier": "1234567890",
                    "SupplierOrderLineItemNumber": "000010",
                    "CustomerPurchaseOrderIdentifier": "T1234567",
                    "CustomerPurchaseOrderItemNumber": "2",
                    "CustomerPurchaseOrderDate": {},
                    "SupplierItemNumberOfUnitsShipped": "000000000001",
                    "SupplierItemBaseUnitOfMeasure": "EA",
                    "SupplierItemGrossWeight": "1.450",
                    "SupplierItemNetWeight": "0.165",
                    "SupplierItemWeightUnitOfMeasure": "KG",
                    "SupplierCommercialInvoiceIdentifier": "987654321",
                    "SupplierCommercialInvoiceItem": "000001",
                    "SupplierCommercialInvoiceUnitprice": "123.000000",
                    "SupplierCommercialInvoiceValue": "123.000000",
                    "SupplierCommercialInvoiceCurrency": "USD",
                    "SupplierCountryOfOriginCode": "PH",
                    "SupplierCountryOfOriginDescription": "Philippines",
                    "SupplierAssemblyCountryOfOriginCode3Character": "PHL",
                    "SupplierAssemblyCountryOfOriginCode2Character": "PH",
                    "SupplierAssemblyCountryOfOriginDescription": "Philippines",
                    "SupplierItemHarmonizedTariffScheduleExportCode": "8901234567",
                    "SupplierItemHarmonizedTariffScheduleExportDescription": "Electronic Integrated Circuits, Other",
                    "SupplierItemHarmonizedTariffScheduleImportCode": "8901234567",
                    "SupplierItemHarmonizedTariffScheduleImportDescription": "Electronic Integrated Circuits, Other",
                    "SupplierItemConfirmDate": {},
                    "SupplierOrderType": "ZJR",
                    "SupplierDeliveryLineItemTotalQuantity": "24000.000",
                    "SupplierDeliveryLineItemTotalQuantityUnitOfMeasure": "EA",
                    "SupplierItemGoodsIssueDate": {},
                    "SupplierItemGoodsIssueTime": "05:23:19",
                    "CustomerItemPassThru1": "ZOI6*00001*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru2": "ZOI6*00002*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru3": "ZOI6*00003*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru4": "ZOI6*00004*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru5": "ZOI6*00005*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru6": "ZOI6*00006*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru7": "ZOI6*00007*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru8": "ZOI6*00008*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru9": "ZOI6*00009*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru10": "ZOI6*00010*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru11": "ZOI6*00011*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru12": "ZOI6*00012*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru13": "ZOI6*00013*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru14": "ZOI6*00014*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru15": "ZOI6*00015*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "SupplierShipTrackCodeList": [
                      {
                        "SupplierShipTrackCode": "012345ABC",
                        "SupplierAlternateShipTrackCode": "HIJKLM",
                        "SupplierChipCountryOfOriginCode3Character": "USA",
                        "SupplierChipCountryOfOriginCode2Character": "US",
                        "SupplierChipCountryOfOriginDescription": "USA",
                        "SupplierItemShipTrackCodeQuantity": "3000",
                        "SupplierBatchNumber": "1234567PHI",
                        "SupplierShipDate": {},
                        "SupplierDateCode": "2110",
                        "SupplierAlternateTrackingIdentifier": "ABCDEFGHIJK"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

Póngase en contacto con el soporte de API para obtener más instrucciones para probar el ASN con su prueba de API.

 

Paso 10: Conozca cómo recuperar un documento financiero

La API de documentos financieros proporciona información de los pagos. Para recuperar una factura mediante la API de documentos financieros, el número de pedido es una parte necesaria de la carga JSON de la recuperación. Los documentos financieros estarán disponibles después de que TI procese el envío.

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

Ejemplo:

curl --request POST \
--url 'https://transact-pre.ti.com/v1/financial-documents/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "CustomerSoldToIdentifier": "123",
  "SupplierFinancialDocumentIdentifier": "1234567890",
  "CustomerReferenceIdentifier": "",
  "SupplierDeliveryIdentifier": "",
  "CustomerPurchaseOrderIdentifier": "",
  "SupplierDocumentStatus": "",
  "SupplierDocumentCreatedFromDate": "",
  "SupplierDocumentCreatedToDate": "",
  "RequestPDF": ""
}

Ejemplo de respuesta:

{
  "CustomerSoldToIdentifier": "123",
  "SupplierFinancialDocumentIdentifier": "1234567890",
  "TotalNumberOfDocuments": "1",
  "Documents": [
    {
      "SupplierDocumentType": "INVOICE",
      "SupplierFinancialDocumentIdentifier": "1234567890",
      "SupplierDocumentCreatedDate": "2020-05-11",
      "SupplierDocumentStatus": "CLEARED",
      "SupplierDocumentCurrency": "USD",
      "CustomerPurchaseOrderIdentifier": "PO1234",
      "CustomerReferenceIdentifier": "0100000200",
      "SupplierGrossWeight": "100.000",
      "SupplierNetWeight": "100.000",
      "SupplierWeightUnit": "GRM",
      "SupplierCarrier": "FEDEX EXPRESS",
      "DocumentValue": {
        "SupplierTotalAmount": "15,000.00"
      },
      "SalesOrder": {
        "SupplierOrderIdentifier": "1000001234",
        "SupplierOrderLineItemNumber": "000000",
        "CustomerPurchaseOrderIdentifier": "PO1234",
        "CustomerPurchaseOrderDate": "2020-01-01"
      },
      "PaymentTerms": {
        "SupplierIncoterms1": "TERMS1",
        "SupplierIncoterms2": "TERMS2",
        "SupplierTermsOfDelivery": "SHIPPING TERMS",
        "SupplierTermsOfPayment": "Net XX Days from Invoice Date",
        "PaymentTermsText": [
          {
            "SupplierPaymentTermsText": "Up to XX.XX.2020 without deduction"
          }
        ]
      },
      "CreditManager": {
        "SupplierCreditManagerName": "Bill Johnson",
        "SupplierCreditManagerTelephone": "1234567890",
        "SupplierCreditManagerEmail": "bj-noreply@ti.com"
      },
      "Delivery": {
        "SupplierDeliveryIdentifier": "0200000300",
        "SupplierDeliveryLineItemNumber": "000000",
        "SupplierDeliveryDate": "2020-04-13",
        "SupplierGoodsMovementDate": "2020-05-11"
      },
      "Waybill": {
        "SupplierWaybillNumber": "123456",
        "SupplierNumberOfBoxes": "1"
      },
      "Partners": [
        {
          "PartnerTypeDescription": "Sender",
          "Name1": "Texas Instruments Incorporated",
          "Name2": "Semiconductor",
          "StreetAddress": "12500 TI Boulevard",
          "City": "Dallas",
          "Region": "TX",
          "PostalCode": "75243",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Remit To",
          "Name1": "For ACH Transfer send to:",
          "Name2": "Texas Instruments ",
          "Name3": "Bank Acct 1234567890, ABA 123456789",
          "Name4": "SWIFT 12345678",
          "City": "DALLAS",
          "Region": "TX",
          "PostalCode": "75202",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Sold-to Party",
          "CustomerNumber": "123",
          "Name1": "TEST CUSTOMER",
          "Name2": " TEST CUSTOMER Line 2",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Bill-to Party",
          "Name1": "TEST CUSTOMER",
          "Name2": "ATTN: ACCOUNTS PAYABLE DEPT",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Ship-to Party",
          "CustomerNumber": "123",
          "Name1": "TEST CUSTOMER",
          "Name2": "TEST CUSTOMER Line 2",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        }
      ],
      "Items": [
        {
          "SupplierOrderLineItemNumber": "000010",
          "SupplierProductIdentifier": "SM1234",
          "CustomerPartNumber": "CPN5678",
          "SupplierProductDescription": "SM1234 description",
          "SupplierItemQuantity": "300.000",
          "SupplierUnitPrice": "50.00",
          "SupplierItemValue": "15,000.00",
          "SupplierGrossWeight": "100.000",
          "SupplierNetWeight": "100.000",
          "SupplierCommercialInvoiceNumber": "1234567890",
          "SalesOrder": {
            "SupplierOrderIdentifier": "1000001234",
            "SupplierOrderLineItemNumber": "000010",
            "CustomerPurchaseOrderIdentifier": "PO1234",
            "CustomerPurchaseOrderLineItemNumber": "1",
            "CustomerPurchaseOrderDate": "2020-01-01"
          },
          "Delivery": {
            "SupplierDeliveryIdentifier": "0200000300",
            "SupplierDeliveryLineItemNumber": "000010",
            "SupplierDeliveryDate": "2020-04-13",
            "SupplierGoodsMovementDate": "2020-05-11",
            "SupplierGrossWeight": "100.000",
            "SupplierNetWeight": "100.000"
          },
          "ItemVAT": [
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "6.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX0000000000"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.500",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804500000"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "1.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.000",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.000",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            }
          ]
        }
      ]
    }
  ]
}

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.

 

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 encabezado identifican el aviso de remesa, la cuenta y la información de pago total del cliente.  La sección de productos puede contener uno o varios registros detallados, con información de pagos específicos 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.ti.com/v1/remittance-advice' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"CustomerRemittanceAdviceIdentifier": "CustomerRemit100",
	"CustomerPayerIdentifier": "CustomerPayer1",
	"CustomerPaymentAmount": "100000",
	"CustomerCurrency": "USD",
	"Items": [
		{
			"CustomerNetPaymentAmount": "20000",
			"SupplierFinancialDocumentIdentifier": "1234567890",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc123"
		},
		{
			"CustomerNetPaymentAmount": "30000",
			"SupplierFinancialDocumentIdentifier": "1234567891",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc124"
		},
		{
			"CustomerNetPaymentAmount": "50000",
			"SupplierFinancialDocumentIdentifier": "1234567892",
			"CustomerFinancialDocumentIdentifier": ""
		}
	]
}
DATA

Ejemplo de respuesta:

{
	"SupplierRemittanceAdviceIdentifier": "0620062214281851",
	"CustomerRemittanceAdviceIdentifier": "CustomerRemit100",
	"CustomerPayerIdentifier": "CustomerPayer1",
	"CustomerPaymentAmount": "100000",
	"CustomerCurrency": "USD",
	"Messages": [
		{
			"Code": "TI-TXT-012013",
			"Type": "INFO",
			"Message": "Remittance Advice 0620062214281851 posted"
		}
	],
	"Items": [
		{
			"CustomerNetPaymentAmount": "20000",
			"SupplierFinancialDocumentIdentifier": "1234567890",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc123"
		},
		{
			"CustomerNetPaymentAmount": "30000",
			"SupplierFinancialDocumentIdentifier": "1234567891",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc124"
		},
		{
			"CustomerNetPaymentAmount": "50000",
			"SupplierFinancialDocumentIdentifier": "1234567892",
			"CustomerFinancialDocumentIdentifier": ""
		}
	]
}

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.