Guía de negocios de API

El conjunto de pedidos API pendientes de TI consta de: API de cotización, gestión de pedidos, recuperación de avisos anticipados de embarque (ASN), recuperación de documentos financieros y aviso de remesa. También hay disponibles API de notificación push para automatizar la introducción de datos en el sistema del cliente. Siga las instrucciones que aparecen a continuación para obtener más información.

Flujo de pedidos de extremo a extremo
Configuración predeterminada de la API
1. Respuesta sincrónica
  1. Con una llamada a la API, el sistema del cliente sabrá si TI procesó completamente la solicitud y si el pedido de venta real se ha cambiado correctamente en el sistema de TI
2. Se permite la creación y modificación parcial de pedidos
  1. Se aceptará la entrada correcta de la línea de pedido API, mientras que los rechazos no se ingresarán
  2. La modificación del pedido API siempre se realizará en el nivel del artículo de línea individual
3. Gestión de errores
  1. Cualquier mensaje de error o advertencia informativa se devolverá en la respuesta de la API, ya sea a nivel de pedido o de línea individual.
  2. Con una lista completa de detalles de advertencia o errores, el cliente tendrá un mejor control sobre cómo y cuándo corregir el error y volver a enviar la solicitud si es necesario
API push
1. Las notificaciones push de API no están habilitadas de forma predeterminada, pero son necesarias para obtener todas las ventajas de las API de TI.
2. Par configurar las notificaciones push de API para pedidos, avisos anticipados de envío y documentos financieros, siga las instrucciones a continuación.
  1. Visite TI.com/support
  2. Seleccione una nueva solicitud de soporte
  3. Seleccione Cumplimiento de pedidos directos del cliente
  4. Rellene el Formulario de notificaciones de la API, adjúntelo y envíelo
API de cotizaciones
1. La API de cotizaciones pendientes permite a los clientes crear cotizaciones y recibir respuestas para productos de TI. Los clientes también pueden recuperar cotizaciones creadas anteriormente
2. Las API de cotizaciones se pueden utilizar para solicitar varias líneas de presupuesto al mismo tiempo para diferentes números de pieza de fabricante (MPN). Si el cliente presenta una cotización con el mismo MPN en varias líneas, TI solo procesará la primera instancia del MPN.
3. Si la cantidad que se solicita al enviar una cotización no se ajusta al valor mínimo del pedido, a la cantidad mínima de pedido (MOQ) o a los múltiplos de la cantidad estándar de envases (SPQ), TI redondeará a la MOQ más próxima en la respuesta a la cotización.

API de gestión de pedidos

Diagrama de flujo de creación y modificación de pedidos

Requisitos para la creación de pedidos de API

Campos obligatorios y opcionales para la creación de pedidos

Elementos de pedidos	Obligatorio/Opcional	Limitaciones de caracteres
Número de orden de compra (PO)	Obligatorio	No más de 35 caracteres; Sin espacio en el número de pedido
Artículo de línea de la orden de compra	Obligatorio
Número de pieza del fabricante (MPN)	Obligatorio
Precio directo del cliente (CDP)	Obligatorio	No más de cinco (5) decimales
Fecha solicitada por el cliente (CRD)	Obligatorio
Cantidad	Obligatorio
Número de pieza del cliente (CPN)	Opcional
Cliente final	Opcional (obligatorio para CM)	MAYÚSCULAS

Para cada línea de pedido, solo se permite UN único CRD
Para cada línea de pedido bajo el mismo número de pedido, el número de artículo no debe duplicarse, de lo contrario el cambio de pedido dará error
Para cada pedido, se aceptan varias líneas de pedido con números de pieza de TI iguales o diferentes
En el caso de una orden de compra con “Cliente final”, solo se pueden aceptar materiales para el mismo cliente final con el mismo número de orden de compra
La cantidad debe ser un múltiplo de la cantidad de paquete estándar (SPQ) de TI y cumplir con el requisito mínimo de pedido (MOQ) y el valor mínimo del artículo (MIV) tal como se define en el catálogo de productos de TI

Reglas de respuesta a los pedidos
1. En el caso de los clientes con entrega parcial permitida, es posible que reciba varios repartos/fechas estimadas de envío (ESD) por línea de pedido, en función de la disponibilidad del producto.

Requisitos de cambio de pedido API

Tipos de cambios de pedidos permitidos
- Ingreso o retiro del CRD
- Actualización del precio del artículo de línea de la orden de compra
- Disminución de la cantidad de artículos de línea de la orden de compra
- Cancelación del artículo de línea de la orden de compra

Plazo para cambios o cancelaciones de pedidos

El período para modificaciones en el pedido (COW) define el lapso de tiempo en el que los cambios o cancelaciones ya no se pueden procesar
- STD (Estándar) COW: 30 días
- No-STD (no estándar) COW: 90 días
TI rechaza todos los cambios que se produzcan en el COW, excepto la introducción de CRD y el cambio de precio

Las reglas de cancelación y reprogramación de COW dependen del tipo de piezas

Para los productos, productos de oblea y productos de matriz, el comprador puede cancelar o reprogramar los pedidos de acuerdo con las siguientes reglas:

Fecha de cancelación o reprogramación solicitada por el comprador	Productos estándar	Productos no estándar
< 30 días antes de la ESD	No se permite	No se permite
Entre 30 y 90 días antes de la ESD	Permitido	No se permite
> 90 días antes de la ESD	Permitido	Requiere la aprobación de TI. Es posible que se apliquen cargos.

Para los artículos de evaluación: Los pedidos de artículos de evaluación no se pueden cancelar ni reprogramar.

Sin perjuicio de las normas anteriores, determinados artículos están sujetos a condiciones especiales de cancelación y reprogramación que TI comunicará al comprador antes de la aceptación del pedido.

Reglas de cambio de pedidos
- Los cambios de pedido se realizan en la línea de pedido
  - La suma de las cantidades de reparto debe coincidir con la cantidad total de la línea de pedido, incluso si el cliente solo desea modificar un reparto concreto
  - La cantidad original completa de la línea de pedido no es necesaria si el cliente solicita una disminución de la cantidad de la línea de pedido
- Para aumentar la cantidad de órdenes de compra por artículos de línea, cree una nueva orden de compra
- Los artículos de línea de la orden de compra que se han enviado por completo, con un aviso de envío anticipado (ASN), no se pueden cambiar
- El cambio de dirección de envío se permite tanto en la cabecera del pedido como en el nivel de artículo de línea en las direcciones de envío del cliente establecidas en TI
- El cliente debe actualizar el precio del artículo de línea de la orden de compra original mediante un cambio de pedido para obtener un nuevo precio efectivo
- Para los clientes con una configuración de entrega completa, el aumento de la cantidad del pedido puede provocar la pérdida de ESD

Gestión de pedidos, avisos y errores
1. Si hay discrepancia de precios entre el CDP y el acuerdo de precios de TI (PA), el resultado será un pedido incompleto que se revisará tanto por el cliente como por TI
  - Si el CDP es correcto, TI actualizará el precio; no es necesario realizar ninguna acción por parte del cliente
  - Si el precio de TI es correcto, usted deberá actualizar el CDP a través del cambio de pedido, se enviará de vuelta una respuesta en la que se indique si la discrepancia de precios está resuelta
2. El pedido no se creará si hay errores de SPQ/MOQ/MIV, corrija la cantidad y vuelva a enviarla a TI como creación del pedido
3. Para ver la lista completa de errores, consulte nuestras listas de errores detalladas:

API de avisos anticipados de embarque (ASN)
1. La API de recuperación de ASN de pedidos pendientes permite a los clientes recuperar información detallada sobre su envío, como el número de seguimiento del envío, la información del transportista y la factura comercial
API de documentos financieros
1. La API de recuperación de documentos financieros de pedidos pendientes permite a los clientes recuperar información sobre facturas financieras, como el número de factura, el importe de la factura y la fecha de la factura.
API de aviso de remesas
1. La API de aviso de remesa pendiente ofrece a los clientes autorizados la posibilidad de enviar información de aviso de remesa que confirma los detalles del pago.
Escenarios de prueba de aceptación del usuario (UAT) para pasar la fase de prueba:
1. Una vez que el cliente complete los escenarios de prueba de autoservicio entre 1.0 y 2.1, nuestro equipo regional de GBO se pondrá en contacto por correo electrónico con el administrador que tenga acceso a las claves de API

Sidebar - Backlog

Guía de negocios de API