PrestaShop

The PrestaShop integration brings orders and customer service messages from your store into Ritevo. You connect it with a webservice key generated in the PrestaShop panel. You translate the store's statuses and payment modules to Ritevo statuses in the mapping on the integration page.

The same PrestaShop store can be connected only once. When you add it again, Ritevo refreshes the existing integration and turns it back on, even if it was deleted.

How to generate the API key

You create the key in the PrestaShop admin panel. Copy it in full - you will paste it into Ritevo when adding the integration.

1. Sign in to the PrestaShop panel and in the left menu choose Advanced Parameters, then Webservice.
2. In the Configuration section set Enable PrestaShop's webservice to Yes and save.
3. Click Add new webservice key. Click Generate, and in the Key description field enter any name, for example "Ritevo".
4. In the Permissions table tick everything: every resource and every action (View, Add, Modify, Delete). Set Status to Yes and save. Copy the key from the Key field.

Connecting the account

Start in Ritevo:

1. Go to Integrations in the left panel and click Add integration in the top right corner.
2. In the Online stores section pick the PrestaShop tile.
3. In the Account name field enter your own name for the integration, for example the store's name.
4. In the Store address field enter the store's full address with https://, without a trailing slash and without /api - for example https://mystore.com.
5. In the Webservice key field paste the key from the PrestaShop panel.
6. Click Add integration. Ritevo connects to the store right away and checks the details: if they are valid, the integration is added and its settings open. If not - you will see the error returned by the store and nothing is saved.

Integration settings

After connecting, the integration is Active, but order fetching is off - you turn it on yourself. On the integration page you will find:

• Account name - your own name for this integration, for example the store's name. You can change it at any time.
• Store address - the address given when adding. It cannot be changed here; a new address or new keys go through Update credentials.
• Fetch orders - once on, Ritevo checks for new and changed orders about every 10 minutes. The rules shared by all channels: Fetching orders.
• Fetch messages - once on, Ritevo fetches customer service threads about every 10 minutes, reaching 7 days back on the first fetch. Shared rules: Fetching messages.
• Order status mapping and Payment method mapping - described below.

Mapping statuses and payments

Every store names its order statuses and payment methods its own way, so with online stores you decide yourself how they translate to Ritevo statuses and methods. You set the mapping once, on the integration page, and it applies to every order fetched from then on.

Order status mapping

Ritevo reads the status list from your store, so you see them under the same names as in the PrestaShop panel. Up front the statuses PrestaShop is installed with are assigned. You assign yourself statuses added by payment modules or by hand. The starting assignment:

• Confirmed - Payment accepted, Processing in progress, Shipped, Delivered, Refunded, Remote payment accepted, Payment received. A refunded order was a real sale, so it stays confirmed.
• Cancelled - Canceled.
• Awaiting payment - Awaiting check payment, Payment error, Awaiting bank wire payment, Awaiting remote payment, Awaiting Cash On Delivery validation.
• Awaiting confirmation - nothing up front; orders with an unassigned status land here too.

One Ritevo status can have several store statuses assigned, but one store status only one Ritevo status. An order with a status you have not assigned anywhere arrives as Awaiting confirmation - you will see it and decide what to do.

Payment method mapping

PrestaShop does not expose a list of payment modules, so here you type the module names by hand - the ones you see in the PrestaShop panel in an order's details or under Modules → Payment (for example ps_wirepayment, payu). Up front the most common modules are filled in. You add yourself other modules and remove the ones you do not need. The starting assignment:

• Bank transfer - ps_wirepayment, ps_checkpayment.
• Cash on delivery - ps_cashondelivery.
• Card - stripe_official.
• PayU - payu.
• PayPal - ps_checkout, paypal.
• P24 - przelewy24.

A payment made with a method you have not assigned anywhere arrives as Other.

What this integration gives you

• Orders - new and changed PrestaShop orders land in the orders table, with the buyer's details, invoice details, delivery and line items with product images.
• Messages - PrestaShop customer service threads land in the inbox; you reply to them from Ritevo.

Orders from PrestaShop

Ritevo fetches the whole PrestaShop order: the customer account with the invoice address, the delivery address and carrier, payments, line items with gross prices and product images. An order changed in the store (for example a new status) is fetched again.

• Statuses and payments - translated according to your mapping, described above. The paid amount is the sum of payments registered in PrestaShop.
• Buyer's note - the comment typed at checkout goes into the order as the buyer's message.
• Additional services - supported. When the buyer chooses gift wrapping or recycled packaging, you see them in the order as separate line items for the whole order, also when they are free. The gift message is supported too - the text the buyer wants added to the parcel. You see it together with the buyer's message, in a Gift message box. More about additional services.
• Discounts - cart rules (discount codes) appear as separate line items with a negative amount, so the items add up to the order total.
• Guest checkout - a guest order is fetched normally.
• Invoice - if PrestaShop provides the buyer's tax id or its equivalent, the order gets the Customer asks for an invoice flag with the company details and the number filled in.

Messages from PrestaShop

Ritevo fetches threads from PrestaShop's Customer Service - both those from the contact form and those attached to an order. Each thread is a conversation in Ritevo:

• Reply - you reply from Ritevo; in PrestaShop the reply is stored as a message from a store employee. There are no disputes or claims - PrestaShop has none.
• Link to the order - a thread about an order is attached to that order in Ritevo.
• Private messages - employee notes marked private in PrestaShop are not fetched.
• Attachments - PrestaShop provides only the name of the attached file, not the file itself. In Ritevo you see the name; open the file in the PrestaShop panel. You cannot send attachments either.

Reconnection required

This state appears when the store stopped accepting the credentials - the key was deleted in the store's panel, lost its permissions, or the store address changed. Until you provide new details, Ritevo neither fetches nor sends any data from that store.

1. Generate new keys in the store's panel - the same way as when connecting for the first time.
2. On the integration page in Ritevo click Update credentials, enter the store address and the new keys and confirm. Ritevo checks them with the store just like when adding - wrong details return an error, valid ones refresh the connection. The mappings, fetching settings and history stay unchanged.

Deleting the integration

Delete integration turns the integration off in Ritevo: it stops fetching and sending data, but what it fetched earlier stays. Restore integration turns it back on.

What the integration does not do

• It does not manage listings: it does not list, change prices or stock in PrestaShop.
• It does not support pickup points (for example parcel lockers). PrestaShop has no standard field for them - each carrier module stores the chosen point on its own, out of the webservice's reach. An order with such a delivery is fetched normally, but without the point; you see a warning about this at the top of the integration page.
• It sends nothing back to PrestaShop: when you change an order's status, create a shipment or issue an invoice in Ritevo, the order in PrestaShop stays unchanged.