inma
Funciones Api: Cursar pedido
noticia publicada el 12/06/2017
leída 11 veces hasta ahora
La API de MATIAS MASSO, S.A. permite cursar pedidos de modo automatizado en formato JSON con el método POST según el siguiente detalle:

Url entorno de pruebas:
https://matiasmasso-api.azurewebsites.net/api/purchaseorder/submit/pruebas

Url entorno de producción:
https://matiasmasso-api.azurewebsites.net/api/purchaseorder/submit

Esquema:

{
"id": "http://api.matiasmasso.es/schemas/purchaseorder/v2.0",
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "M+O Purchase Order",
"description": "purchase order to submit to MATIAS MASSO, S.A.",
"type": "object",
"required": [
"user",
"customer",
"items"
],
"properties": {
"user": {
"description": "The customer authorized user under which credentials the current order is submitted",
"type": "object",
"additionalProperties": true,
"properties": {
"guid": {
"description": "The unique identifier for the user",
"type": "string",
"pattern": "^([0-9A-Fa-f]{8}[-][0-9A-Fa-f]{4}[-][0-9A-Fa-f]{4}[-][0-9A-Fa-f]{4}[-][0-9A-Fa-f]{12})$"
}
},
"customer": {
"description": "The customer who places the order",
"type": "object",
"additionalProperties": true,
"properties": {
"guid": {
"description": "The unique identifier for the customer",
"type": "string",
"pattern": "^([0-9A-Fa-f]{8}[-][0-9A-Fa-f]{4}[-][0-9A-Fa-f]{4}[-][0-9A-Fa-f]{4}[-][0-9A-Fa-f]{12})$"
}
},
"obs": {
"description": "Customer free text to identify this particular order on shipments and invoices",
"type": "string",
"maxLength": 60
},
"items": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"title": "Order item",
"type": "object",
"required": [
"qty",
"sku"
],
"additionalProperties": true,
"properties": {
"qty": {
"description": "number of units requested",
"type": "number",
"minimum": 1
},
"sku": {
"description": "M+O product code",
"type": "object",
"additionalProperties": true,
"properties": {
"id": {
"description": "The unique identifier for a M+O product",
"type": "number",
"pattern": "^([1-9][1-9][1-9][1-9][1-9])$"
}
}
}
}
}
}
}
}
}
}

Para ello se necesitarán dos identificadores que deberán solicitarse a nuestras oficinas:
  • El identificador Guid del objeto Customer, que identifica el cliente que cursa el pedido

  • El identificador Guid del objeto User, que identifica la cuenta de usuario con correo electrónico registrado en nuestra base de datos y autorizado para operar la cuenta del cliente


El sistema devuelve el mismo objeto en formato JSON con una serie de campos adicionales.
En caso de respuesta satisfactoria,
  • Numero de pedido en el campo Id del objeto raiz (en entorno de pruebas siempre devuelve el 11111)

  • Importe del pedido antes de impuestos en el campo Eur del objeto raiz

  • Correo electronico del usuario en el campo Nom del objeto User

  • Nombre del cliente en el campo Nom del objeto Customer

  • Precio de coste, precio de venta y nombre de cada producto en el objeto Sku



No hay comentarios aún. ¡Sé el primero en colgar uno!

Esta página requiere Javascript y cookies habilitadas en su navegador.

Por favor seleccione las opciones correspondientes en el apartado de configuración y refresque la página.