Alanube is a Panama-authorized certification provider (PAC) that intermediates between CifraHQ and the government ETAX system. This page covers the Alanube provisioning wizard, sucursal management, QR security codes, and certificate renewals.
This page covers the Alanube integration (PAC Setup). For the WebPOS invoice submission integration see Electronic Invoicing (Panama).
Navigate to Advanced Setup > Electronic Invoicing - Alanube.
The Alanube admin screen opens with a status card showing your current affiliation state:
| Status | Meaning |
|---|---|
| Subscribed | Affiliation complete. Invoices are being submitted through Alanube. |
| Requested | Application submitted to Alanube; awaiting government approval. |
| Pending | Additional documentation or steps required before submission. |
| Failed | Affiliation attempt was rejected. Review error details and re-provision. |
Additional information shown on the card: environment (Production or Test), RUC, Razon Social, QR code status, and certificate expiry date. A warning banner appears when the digital certificate is within 30 days of expiry.
If your company has not yet affiliated with Alanube, click Start Provisioning to open the six-step wizard.
| Field | Notes |
|---|---|
| RUC Type | Natural person, Legal entity, or Foreign |
| RUC Number | Without check digit |
| DV (check digit) | Calculated automatically or entered manually |
| Legal Name (Razon Social) | Must match your MEF registration exactly |
| Company Type | Contribuyente, Agente de Retenciones, etc. |
| Document Types | Select all invoice types you issue: FE-01 (Consumer), FE-02 (Tax), FE-03 (Credit Note), FE-04 (Debit Note) |
| Fiscal Address | Street, district, province |
| Phone | Contact number registered with MEF |
| Contact Email | Receives Alanube notifications |
| Email Body | Default body text for emailed Invoices |
| Logo URL | Public URL to your company logo (appears on electronic Invoices) |
Upload the two .p12 certificate files provided by your certification authority:
Keep a copy of both files and their passwords in a secure location. You will need them again when certificates expire.
Every company requires at least one sucursal (branch) registered with ETAX.
| Field | Notes |
|---|---|
| Branch Code | Short code (e.g., 001) |
| Branch Name | Descriptive name (e.g., Main Office) |
| Address | Physical address of the branch |
| District | Panama district (from the Geography catalog) |
| Province | Panama province |
| Phone | Branch contact number |
Paste a QR security code issued by Alanube to embed a tamper-evident QR on each printed invoice. If you do not yet have a code you can skip this step and add it later from the Alanube admin screen.
Review all entered information. Click Submit to Alanube to send the provisioning request. CifraHQ transmits the data to Alanube via their API; Alanube forwards it to the MEF government portal.
After submission, Alanube displays a confirmation code and directs you to finalize registration at:
https://etax2.mef.gob.pa
Log in to the government portal with your RUC credentials and confirm the affiliation request. Once confirmed, your status in CifraHQ updates to Subscribed on the next sync.
After provisioning you can add, edit, or remove sucursales from the Alanube admin screen.
To add a sucursal:
Each sucursal receives its own sequence of electronic invoice numbers from ETAX.
To edit or delete a sucursal: click the row action menu ( three dots ) next to the sucursal and choose Edit or Delete. Deleting a sucursal that has issued Invoices is blocked by Alanube; you must void all open Invoices for that sucursal first.
Each sucursal can have a QR security code that Alanube issues separately from the provisioning step.
To add or update a QR code for a sucursal:
To regenerate a QR code (if the existing one has been compromised): click Regenerate from Alanube. CifraHQ calls Alanube's API to issue a new code and updates the record automatically.
Digital certificates typically expire every 2 years. CifraHQ shows a warning banner 30 days before expiry.
To renew:
.p12 certificate files from your certification authority..p12 files with their passwords.Do not wait until expiry. Invoices cannot be submitted to ETAX while the certificate is expired, and voiding or issuing Invoices will fail until renewed.
AP1010 means the QR security code submitted with an invoice does not match the code registered in the Alanube system for that sucursal.
To resolve:
If the mismatch persists after updating, contact Alanube support to verify the code registered on their end.
Related: Electronic Invoicing (Panama) - Invoices - Tax Codes - CBSP Codes
Was this page helpful?