Difference between revisions of "B2BRouter integration"

From Protemos Wiki
Jump to: navigation, search
(→‎B2BRouter configuration)
 
(11 intermediate revisions by the same user not shown)
Line 15: Line 15:
  
  
−
You can find the B2Brouter API key and B2Brouter account ID in your B2BRouter account by going to Settings -> API Key tab:
+
You can find the B2Brouter API key and B2Brouter account ID in your B2BRouter account in the API Key tab:
  
 
[[File:B2brouter 3.png|border|1000 px]]
 
[[File:B2brouter 3.png|border|1000 px]]
−
 
  
 
=='''B2BRouter configuration'''==
 
=='''B2BRouter configuration'''==
Line 26: Line 25:
 
[[File:B2brouter 4.png|border|1000 px]]
 
[[File:B2brouter 4.png|border|1000 px]]
  
−
If there are mismatches, the orange text plate is shown.
+
If there are mismatches, the orange text plate is shown. Please pay attentions to the mismatched values.
−
Please pay attentions to the mismatched values:
+
 
 +
The required values are in the orange text plate (highlighted with green), the current values are listed below (highlighted with red):
  
 
[[File:B2brouter 5.png|border|1000 px]]
 
[[File:B2brouter 5.png|border|1000 px]]
  
−
These settings can be accessed from the "Invoices and quotes" section in your B2BRouter account settings:
+
These settings can be accessed in the "Invoices and quotes" section in your B2BRouter account settings:
  
 
[[File:B2brouter 6.png|border|500 px]]
 
[[File:B2brouter 6.png|border|500 px]]
  
 +
Having set up the integration, you will be able to push client invoices from Protemos to B2BRouter or link them with already existing ones.
  
 +
=='''Create or link B2BRouter invoices'''==
  
 +
Please go to the "Linked B2BRouter invoice details" section on the invoice page and use the needed option:
  
 +
[[File:B2brouter 7.png|border|1000 px]]
  
 +
Then, you will see the created/linked B2BRouter invoice in the corresponding section:
  
 +
[[File:B2brouter 8.png|border|1000 px]]
  
  
 +
=='''Issues with creating B2BRouter invoices'''==
  
−
Having enabled the integration, you will be able to push client invoices to QuickBooks or link them with already existing ones.
+
The invoices can be created only if certain conditions are met.
−
 
 
−
Please go to the "Linked QuickBooks invoice details" section on the invoice page and use the needed option:
 
−
 
 
−
[[File:QB1.png|border|1000 px]]
 
−
 
 
−
=='''Create QuickBooks invoices from Protemos client invoices'''==
 
−
 
 
−
Open the needed client invoice, then scroll down to the '''Linked QuickBooks invoice details''' section and click '''"Create QuickBooks invoice"''':
 
−
 
 
−
[[File:Create quickbooks invoice.1.png|border|1000px]]
 
−
 
 
−
Then, you will see the created QuickBooks invoice in the corresponding section:
 
−
 
 
−
[[File:Quickbooks invoice created.png|border|1000px]]
 
−
 
 
−
You may open the invoice by clicking QuickBooks invoice ID:
 
−
 
 
−
[[File:Open qb invoice.png|border|1000px]]
 
−
 
 
−
Please note that the invoice will be created only if the corresponding client, services, payment terms, and taxes are already predefined in your Quickbooks account.
 
−
 
 
−
::<span style="color:orange">'''Note:'''</span> To push the invoice into Quickbooks, the client name on Protemos should perfectly match the "Customer display name" on Quickbooks.
 
−
 
 
−
=='''Link and unlink invoices between Protemos and QuickBooks'''==
 
−
 
 
−
When you create a QuickBooks invoice based on a Protemos client invoice, the invoices in the two systems are linked with each other.
 
−
 
 
−
But you may also link a Protemos invoice with a QuickBooks invoice which was created in QuickBooks independently.
 
−
 
 
−
To do so, click the '''"Link QuickBooks invoice"''' button:
 
−
 
 
−
[[File:Link quickbooks invoice.png|border|1000px]]
 
−
 
 
−
Then, click the '''"Link"''' button in the respective line:
 
−
 
 
−
[[File:Select invoice to link.png|border|1000px]]
 
−
 
 
−
The invoices will be linked.
 
−
 
 
−
You may always unlink the invoices by clicking the '''"Unlink QuickBooks invoice"''' button:
 
−
 
 
−
[[File:Unlink qb invoice.png|border|1000px]]
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
 
 
−
Protemos and Memsource are integrated through '''[https://belazy.cat/ BeLazy].'''
 
  
−
If you do not have a Memsource account, you can register it at '''[https://memsource.com memsource.com]'''.
+
Some common reasons for errors:
 +
# There is no matching client in B2BRouter (can be created in Create -> Create contact)
 +
# There is no tax or an absolute tax in a Protemos invoice.
 +
# The payment method details are invalid (for example, invalid IBAN)
  
−
To enable the integration, please contact BeLazy team at '''info@belazy.cat'''. More contact details here: [https://belazy.cat/contact-us/ Contact us | BeLazy].
+
There may be other cases, and often the reason for the invoice not being created is diplayed in the error message.
  
−
To get a better idea of the way the integration works, please check this video: [coming soon].
+
If you need assistance with creating invoices, you may contact us at support@protemos.com.
 +
Please provide all the necessary screenshots, keeping the URLs of the pages (do not cut the screenshots).

Latest revision as of 14:14, 20 March 2026


Enable B2BRouter integration

To enable the B2BRouter integration, please go to Settings -> Integrations -> B2BRouter or use this link: [B2BRouter integration]

Click "Enable":

B2brouter 1.png

To enable the integration, you need to input your B2Brouter API key and B2Brouter account ID and click "Update":

B2brouter 2.png


You can find the B2Brouter API key and B2Brouter account ID in your B2BRouter account in the API Key tab:

B2brouter 3.png

B2BRouter configuration

Before using the integration, you need to adjust B2BRouter calculation algorithms in order to avoid amount discrepancies. If everything is set up correctly, the following blue text plate is displayed:

B2brouter 4.png

If there are mismatches, the orange text plate is shown. Please pay attentions to the mismatched values.

The required values are in the orange text plate (highlighted with green), the current values are listed below (highlighted with red):

B2brouter 5.png

These settings can be accessed in the "Invoices and quotes" section in your B2BRouter account settings:

B2brouter 6.png

Having set up the integration, you will be able to push client invoices from Protemos to B2BRouter or link them with already existing ones.

Create or link B2BRouter invoices

Please go to the "Linked B2BRouter invoice details" section on the invoice page and use the needed option:

B2brouter 7.png

Then, you will see the created/linked B2BRouter invoice in the corresponding section:

B2brouter 8.png


Issues with creating B2BRouter invoices

The invoices can be created only if certain conditions are met.

Some common reasons for errors:

  1. There is no matching client in B2BRouter (can be created in Create -> Create contact)
  2. There is no tax or an absolute tax in a Protemos invoice.
  3. The payment method details are invalid (for example, invalid IBAN)

There may be other cases, and often the reason for the invoice not being created is diplayed in the error message.

If you need assistance with creating invoices, you may contact us at support@protemos.com. Please provide all the necessary screenshots, keeping the URLs of the pages (do not cut the screenshots).

Retrieved from "https://wiki.protemos.com/index.php?title=B2BRouter_integration&oldid=25356"