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

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

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:#