inma
Funciones Api: Cursar pedido
post published on 12/06/2017
read 35 times until now
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 comments yet. Be the first to post one!

Sorry this site requires both Javascript and cookies enabled on your browser.

Please select the right options in your browser configuration and refresh the page.