Create order

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

Create a delivery request.

Parameters.

  • idEstimation: this represents the response of the request estimation order idEstimation.

  • idDelivery: this represents the response of the request estimation order id.

The following list shows the possible errors controlled for corrections.

  • ERRORDATAGEOLOCATION: Displayed in case geoposition data is missing either at the delivery point or the collection point.

  • OUTZONECOVERAGE: In case the indicated geoposition is outside the coverage area.

  • ERRORESTIMATION: error with the estimate number that you are trying to request.

  • ERRORLENGTH: error with the length of a product description, it exceeds 256 characters.

  • INTERNAL ERROR: internal error when trying to create the package

  • ERRORLENGTHNOTE: exceeds the maximum length allowed for a note of 256 characters.

  • PENDINGINFO: In case the user who owns the account has pending information regarding his or her account

  • NOEXISTPAYMENTMETHOD: You do not have a payment method registered in the profile, be it a card, wallet or credit to make the request.

  • INVALIDTOKEN: when the access token is invalid

Documents

The documents are requested by the Moover in the delivery point.

Document type.

It is vitally important to be very clear in the document you are requesting. For example, if it is the front or back of the ID, in the case of both, each must be requested as one document.

  • image: when you require a photo of a document. For example the ID.

  • document: collection of a physical document.

Note: The url fields are optional if you have an electronic address where you can see the process that rl moover must follow with the requested requirement.

Charges (Optional)

In case of charges at the delivery point.

  • currency.

    • colones (Costa Rica)
    • lempira (Honduras)
    • peso (chile)
    • dollars
  • method:

    • cash.
    • creditCard.
    • collectMoneyExchange.
    • deliveryMoneyExchange.
  • amount: amount

Charges errors

The following list shows the possible errors handled when including packet charges:

  • ERRORPAYMENTTYPE: The specified payment method is invalid

  • ERRORPAYMENTNOTAVAILABLE: the specified payment method is not enabled

  • ERRORPAYMENTCURRENCY: the specified payment currency is not enabled

  • ERRORPAYMENTAMOUNT: the indicated amount of the charge is not within the minimumAmount and maximumAmount values

Notes

  • cediMoovin: This is used if the products are located at a Moovin headquarters.

  • prepared: This indicates which order is ready for pickup. So the process of confirming that the order is ready (Order ready for pickup) should not be implemented.

Request Body

{"idEstimation"=>5167, "idDelivery"=>3, "cediMoovin"=>false, "idOrder"=>"343842390jdsh3ju03424", "email"=>"ejimenez@moovin.me", "emailAccount"=>"ejimenez@movin.me", "prepared"=>true, "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"}], "ensure"=>true}

HEADERS

KeyDatatypeRequiredDescription
tokenstring
Content-Typestring

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"}