Crear Orden

Descripción

Este servicio permite a los Resellers generar una orden de compra con los datos del cliente y los productos seleccionados. Incluye opciones para agregar notas, especificar detalles del cliente, y requerir firma para garantizar un proceso de compra eficiente y seguro.

Cómo Funciona

Proporciona la Información de la Orden: Envía los detalles necesarios, como el número de la orden, notas, datos del cliente y productos.

Envía los Detalles del Cliente: Incluye información detallada del cliente como nombre, dirección y contacto.

Añade Productos a la Orden: Especifica los productos a ordenar utilizando los Ingram Part Numbers, junto con la cantidad requerida.

Especifica Configuraciones Adicionales: Selecciona el código de sucursal para entrega y si es necesario requerir firma del cliente.

Consideraciones Importantes

Tokens de Creación: Es obligatorio incluir el token de autorización en el encabezado de la solicitud para garantizar acceso seguro.

Configuración de Paqueteria: El código de sucursal define dónde se procesará la orden. Usa MU para CDMX y NL, o E1 para entregas en todas las ubicaciones.

Límites de Productos: Se permite incluir hasta 187 productos por solicitud.

Respuesta del Servicio

El sistema procesa la orden y devuelve una confirmación con los detalles ingresados.

Campos de la Respuesta

Número de Orden: Identificador único asignado a la orden generada.

Productos Confirmados: Lista de productos incluidos en la orden con sus cantidades.

Estado de la Orden: Confirmación del éxito o detalles de cualquier error en el procesamiento.

Beneficios de Este Servicio

Gestión Completa de Órdenes: Centraliza todos los detalles necesarios para procesar una orden de manera eficiente.

Flexibilidad en Configuración: Personaliza la orden con notas, detalles del cliente, y requerimientos adicionales como firmas.

Compatibilidad de Entrega: Soporte para entregas en múltiples sucursales mediante códigos configurables.

Seguridad y Control: El uso de tokens de acceso asegura que solo usuarios autorizados puedan generar órdenes.

Optimización Operativa: Permite procesar grandes volúmenes de productos en una sola solicitud, ahorrando tiempo y recursos.

Estados Disponibles y Abreviaturas

A continuación, se muestra la lista de estados aceptados, junto con sus abreviaturas:

Estado	Abreviatura
Aguascalientes	AG
Baja California	BN
Baja California Sur	BS
Campeche	CA
Ciudad de México	CM
Chiapas	CS
Chihuahua	CH
Coahuila	CO
Colima	CL
Durango	DU
Estado de México	ME
Guanajuato	GU
Guerrero	GR
Hidalgo	HI
Jalisco	JA
Michoacán	MI
Morelos	MO
Nayarit	NA
Nuevo León	NL
Oaxaca	OA
Puebla	PU
Querétaro	QU
Quintana Roo	RO
San Luis Potosí	SL
Sinaloa	SI
Sonora	SO
Tabasco	TB
Tamaulipas	TM
Tlaxcala	TL
Veracruz	VE
Yucatán	YU
Zacatecas	ZA

Notas:

Todos los nombres deben ingresarse con acentos, si corresponden.

Si el estado ingresado no está en la lista, el valor predeterminado será "CM" (Ciudad de México).

Este servicio es ideal para gestionar órdenes de compra de manera eficiente, asegurando un flujo de trabajo centralizado y seguro. Con opciones para personalizar detalles y configuraciones adicionales, facilita la integración con sistemas empresariales y plataformas de comercio electrónico.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

numeroOrden

string

required

Numero de Pedido o Orden

<= 10 characters

Example:

orden12217

notas

string

required

Notas de la orden

<= 100 characters

Example:

Orden de Compra

datosCliente

array [object {8}]

required

Array de datos del cliente

nombre

string

required

Nombre del cliente

<= 34 characters

Example:

Jose Angel Bandillo Ortiz

compania

string | null

optional

Compañia o Empresa del cliente

<= 34 characters

Example:

Blue Diamond Innovation

telefono

string

required

Telefono del cliente

<= 10 characters

Example:

5521269852

calle

string

required

Calle del cliente

<= 35 characters

Example:

Avenida Siempre Viva

colonia

string

required

Colonia del cliente

<= 35 characters

Example:

Polanco

ciudad

string

required

Ciudad del cliente

<= 25 characters

Example:

Miguel Hidalgo

estado

string

required

Estado del cliente

<= 50 characters

Example:

Ciudad de México

codigoPostal

string

required

Codigo Postal del cliente

<= 10 characters

Example:

42963

productos

array [object {1}]

required

Array de Productos

<= 187 items

IngramPartNumber

string

required

Añadir ingramPartNumber del producto a ordenar

Example:

J170004

codigodeSucursal

string

required

Añadir codigo de Surcursal MU solo para CDMX y NL o E1 para todos.

<= 2 characters

Examples:

MUE1

requerirFirma

boolean

required

Requerir Firma del Cliente

Default:

false

Example

{
    "numeroOrden": "RSF_12217",
    "notas": "Orden de Compra",
    "datosCliente": {
        "nombre": "Jose Angel Badillo Ortiz",
        "compania": "",
        "telefono": "521268978",
        "calle": "Av Siempre Viva",
        "colonia": "Polanco",
        "ciudad": "Miguel Hidalgo",
        "estado": "Ciudad de México",
        "codigoPostal":"42960"
    },
    "productos": [
        {
            "IngramPartNumber": "J170004",
            "Cantidad": 2
        },
         {
            "IngramPartNumber": "0B17605",
            "Cantidad": 5
        }
    ],
    "codigodeSucursal": "MU",
    "requerirFirma": false
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

customerOrderNumber

string

optional

shipToInfo

object

optional

contact

string

optional

companyName

string

optional

addressLine1

string

optional

addressLine2

string

optional

city

string

optional

state

string

optional

postalCode

string

optional

countryCode

string

optional

orders

array [object {9}]

optional

numberOfLinesWithSuccess

integer

optional

numberOfLinesWithError

integer

optional

numberOfLinesWithWarning

integer

optional

ingramOrderNumber

string

optional

ingramOrderDate

string

optional

notes

string

optional

lines

array [object {13}]

optional

miscellaneousCharges

array [object {4}]

optional

rejectedLineItems

array [object {7}]

optional

Example

{
  "customerOrderNumber": "ORD12345",
  "shipToInfo": {
    "contact": "Jose Angel",
    "companyName": "Blue Diamond Innovation",
    "addressLine1": "Avenida Siempre Viva",
    "addressLine2": "Suite 202",
    "city": "Miguel Hidalgo",
    "state": "CDMX",
    "postalCode": "42963",
    "countryCode": "MX"
  },
  "orders": [
    {
      "numberOfLinesWithSuccess": 2,
      "numberOfLinesWithError": 1,
      "numberOfLinesWithWarning": 0,
      "ingramOrderNumber": "ING123456",
      "ingramOrderDate": "2024-11-25",
      "notes": "Orden procesada parcialmente.",
      "lines": [
        {
          "subOrderNumber": "SUB123",
          "ingramLineNumber": "LINE123",
          "customerLineNumber": "CLINE123",
          "lineStatus": "Confirmed",
          "ingramPartNumber": "J170004",
          "vendorNumber": "VN123",
          "unitPrice": 100.5,
          "extendedUnitPrice": 201.0,
          "quantityOrdered": 2,
          "quantityConfirmed": 2,
          "quantityBackOrdered": 0,
          "notes": "Entrega inmediata.",
          "shipmentDetails": {
            "carrierCode": "UPS",
            "carrierName": "UPS Logistics",
            "shipFromWarehouseId": "WH123",
            "shipFromLocation": "CDMX",
            "signatureRequired": false
          }
        },
        {
          "subOrderNumber": "SUB124",
          "ingramLineNumber": "LINE124",
          "customerLineNumber": "CLINE124",
          "lineStatus": "BackOrdered",
          "ingramPartNumber": "0B17605",
          "vendorNumber": "VN124",
          "unitPrice": 50.0,
          "extendedUnitPrice": 250.0,
          "quantityOrdered": 5,
          "quantityConfirmed": 3,
          "quantityBackOrdered": 2,
          "notes": "Parte de la orden en espera.",
          "shipmentDetails": {
            "carrierCode": "FEDEX",
            "carrierName": "FedEx Express",
            "shipFromWarehouseId": "WH456",
            "shipFromLocation": "NL",
            "signatureRequired": true
          }
        }
      ],
      "miscellaneousCharges": [
        {
          "subOrderNumber": "SUB123",
          "chargeLineReference": "CHG123",
          "chargeDescription": "Envío estándar",
          "chargeAmount": 15.0
        }
      ],
      "rejectedLineItems": [
        {
          "customerLinenumber": "CLINE125",
          "ingramPartNumber": "B123456",
          "vendorPartNumber": "V123456",
          "customerPartNumber": "C123456",
          "quantityOrdered": 1,
          "rejectCode": "R01",
          "rejectReason": "Producto no disponible"
        }
      ]
    }
  ]
}

Descripción#

Cómo Funciona#

Consideraciones Importantes#

Respuesta del Servicio#

Campos de la Respuesta#

Beneficios de Este Servicio#

Estados Disponibles y Abreviaturas#

Notas:#

Request

Request samples

Responses

Descripción

Cómo Funciona

Consideraciones Importantes

Respuesta del Servicio

Campos de la Respuesta

Beneficios de Este Servicio

Estados Disponibles y Abreviaturas

Notas: