Set up your Petrolimex ID credential

How-to guide Who can do this: Tenant Owner, Tenant Admin, Platform Operator

Petrolimex invoices are fetched with your company's own Petrolimex ID login. Store it once on your company page; the same login also makes Petrolimex stations available to your drivers.

Before you start#

• Role: Tenant Owner or Tenant Admin for your own company; a Platform Operator can do it for any company.
• Where: your company page (Tenants in the web portal sidebar; a Platform Operator opens Tenants and then the company), the Petrolimex ID Credential card.
• What you need: the username and password of your company's Petrolimex ID account, and the tax code number Petrolimex knows your company by.
• One login for all of Petrolimex. Your company has one Petrolimex ID credential, used for every Petrolimex merchant and station; you do not pick a merchant.

Steps#

1. On your company page, click Manage on the Petrolimex ID Credential card. When no credential exists yet, Set up Petrolimex ID on the card goes straight to the form.
2. Click Add Petrolimex ID credential.
3. Enter the Username and Password. Both are required.
4. Enter the Tax code number. The form does not require it, but Petrolimex invoices are looked up by it, so without it no invoices are found.
5. Leave Provider location code blank to match invoices from any store, or enter one station code to restrict matching to that station.
6. Click Save. You see Petrolimex ID credential saved.

To change it: on the credential page click Edit. The stored password shows masked; to enter a new one, click Change next to it, type it and click Save. To keep the stored password, leave it as it is: Leave blank to keep the current password.

To pause it: on Edit, turn off Sync enabled and save. Pausing keeps the credentials; no data is fetched until resumed. To resume, click Resume (or Edit), turn Sync enabled back on and click Save.

To remove it: click Remove credential and confirm with Yes, remove. You see Petrolimex ID credential removed.

What happens next#

Removing the credential hides vehicles' Petrolimex QRs but does not delete them; they reappear when a credential is added again. The full station visibility rules are on Which stores tenants and drivers can see.

Next, give each vehicle its Petrolimex QR: Add or replace a vehicle's Petrolimex QR.

Rules and limits#

• The password is never shown again. After saving, the credential page shows the password only masked. The username and password are stored encrypted.
• One per company. If a credential already exists, adding takes you to editing it instead.
• The login is not tested when you save. If it is wrong, the scheduled fetch fails and no invoices arrive; check that invoices appear after the next fetch.
• Changes are recorded. Every change is recorded in the audit log, without the username or password.

If something goes wrong#

Related#

• Add or replace a vehicle's Petrolimex QR
• Refuelling at Petrolimex stations (static QR)
• Which stores tenants and drivers can see