Crear orden

POST {{url}}/moovinApiWebServices-{{country}}/rest/api/ecommerceExternal/createOrder

Crear una solicitud de entregas.

Cuando se crea una orden se debe generar el código QR con la respuesta de la solicitud. La información que contiene este QR es parámetro orderQR de la respuesta , la misma debe estar impresa para control el Moover (Mensajero) que la recoja y el tracking del paquete. Se requiere que se identifique imprimiendo en la boleta el número de paquete y el logo de Moovin el cual puede descargar
aquí.

Parámetros.

• idEstimation: representa la respuesta del llamado de la estimación idEstimation.

• idDelivery: corresponde al id de cada una de las estimaciones.

Estados

• SUCCESS: se completo correctamente.
• ERRORZONE: no se encuentra dentro de la zona de cobertura de moovin.
• ERRORDANGERZONE: El punto se encuentra en una zona peligrosa, por lo que moovin no realiza la entrega.

Errores

En la siguiente lista se muestrar los posibles errores controlados para tener las correcciones.

• ERRORESTIMATION: Error con el número de estimación que se intenta solcitar.

• ERRORLENGTH: Error con el largo de la descripción de un producto, supera los 256 caracteres.

• ERRORINTERNAL: Error interno al intenter crear paquete.

• ERRORLENGTHNOTE: Supera el largo permitido para una nota de 256 caracteres.

• PENDINGINFO: En caso de que, el usuario dueño de la cuenta tenga información pendiente, referente a su cuenta.

  • Datos adicionales
    • paysService: pagos pendientes.
    • paymentMethod: problemas con el método de pago.
    • email: problemas con el correo del dueño de la cuenta, no se ha registado un correo o no ha sido confirmado.
    • phone: problemas con el teléfono del dueño de la cuenta, no se ha registado un teléfono o no ha sido confirmado.

• NOEXISTPAYMENTMETHOD: No cuenta con un método de pago registrado al perfil ya sea una tarjeta, billetara o crédito para realizar la solicitud.

• INVALIDTOKEN: Cuando el token de accesso es inválido.

Documentos

La solicitud de documentos se realizará por parte del Moover en el punto de entrega.

Tipos de documentos.

Es de vital importancia ser muy claros en el documento que se desea solicitar. Por ejemplo, si es el anverso o reverso de la cédula, en el caso de sea ambos se debe solcitar como un documento cada uno.

• image: Cuando se requiera una foto de un documento. Por ejemplo la cédula.

• document: Recolección de un documento físico.

Nota: Los campos url es opcional es en caso de contar con una dirección electrónica donde se pueda ver el proceso que debe seguir el moover con el requisito solicitado.

Para cobros (Opcional)

Esta opción se debe enviar si se requiere realizar cobros en el momento de entrega.

Para configurar las cobros o cambio de dinero se tiene los siguientes parámetros.

• currency: En las monedas
  • colones
    
  • dollars

• method:

  • cash: cobro en efectivo
    
  • creditCard: cobro en tarjeta
    
  • mix: cobro fracionado
  • collectMoneyExchange: cambio a recoger (se debe recoger en el primer punto).
  • deliveryMoneyExchange: cambio a entregar.

• amount : monto

Errores de cobros

En la siguiente lista se muestran los posibles errores controlados cuando se incluyen cobros al paquete:

• ERRORPAYMENTTYPE: el método de cobro especificado no es válido.

• ERRORPAYMENTNOTAVAILABLE: el método de cobro especificado no está habilitado.

• ERRORPAYMENTCURRENCY: la moneda del cobro especificado no está habilitada.

• ERRORPAYMENTAMOUNT: el monto indicado del cobro no está dentro de los valores minimumAmount y maximumAmount

Notas

• cediMoovin: Se utiliza si los productos se encuentran en una sede de Moovin.
• prepared: Indica que la orden se encuentra lista para recoger. Por lo que el proceso de confirmar que la orden esta lista (Orden lista para recoger) no se debe implementar. Este parámetro solo debe ser incluido para el proceso de entrega en en ruta en caso de ser un servicio express no se debe agregar en el momento de crear el paquete.
• packageReal: Este parámetro permite indicarle que las tamaños de los puductos enviados par su creación corresponde a la cantidad de paquetes creales que que va a utilizar para enpacar los productos.

Lista de productos.

En esta sección se detalla uan breve explición de parámetros que nos brindan beneficios dependiendo de la operativa del cliente. Cabe menciona que muchos de ellos dependeran de la ioperativa de cada uno de los clientes.

• idReference(opcional): permite pode generar una refrenecia de control si se debesea poder identificar cada una de las cajas (empaques) que se van autilizar para entregar un pedido del cliente.

• totalPackage(opcional): permite poder identificar la cantidad de productos a nivel unitario que se han empacado en cada una de las cajas

Request Body

{"idEstimation"=>9540, "idDelivery"=>2, "idOrder"=>"343842390jdsh3ju03424", "email"=>"ejimenez@moovin.me", "emailAccount"=>"ejimenez@movin.me", "pointCollect"=>{"latitude"=>9.929652, "longitude"=>-84.134719, "locationAlias"=>"Moovin", "name"=>"Edward", "phone"=>"87988684", "identificationCard"=>"11XXXX680", "notes"=>"Decirle que es frágil"}, "pointDelivery"=>{"latitude"=>9.929652, "longitude"=>-84.134719, "locationAlias"=>"Autopista 27", "name"=>"Daniel Somlo", "identificationCard"=>"124450570", "phone"=>"87988684", "notes"=>"Casa de color amarilla", "documents"=>[{"name"=>"Cédula", "fields"=>[{"name"=>"Cédula frontal", "type"=>"image", "description"=>"Que la cédula se encuentre en perfecto estado", "url"=>"Información sobre prodecimiento"}, {"name"=>"Cédula reverso", "type"=>"image", "description"=>"Que la cédula se encuentre en perfecto estado", "url"=>"Información sobre prodecimiento"}]}, {"name"=>"Contancia salarial", "fields"=>[{"name"=>"Constancia al día", "type"=>"document", "description"=>"Recoger contancia salarial con 30 días de vigencia"}]}], "listPayment"=>[{"description"=>"Total de cobro", "amount"=>1000, "currency"=>"colones", "method"=>"cash"}]}, "listProduct"=>[{"quantity"=>1, "nameProduct"=>"Samsumg", "description"=>"Galaxy S7", "length"=>16, "width"=>4.5, "high"=>12, "weight"=>0.4, "price"=>200000, "codeProduct"=>"234234234234"}]}

HEADERS

RESPONSES

status: OK

{"idPackage":848,"orderQR":"idPackage\u003cMN\u003e848||fullName\u003cMN\u003eDaniel Somlo||phone\u003cMN\u003e8917**41||identification\u003cMN\u003enull","status":"SUCCESS","message":"Complete payment"}