They are answered by the XTRF community and our experts


Subscription API - callback

Eric Kruis 5 years ago in API updated by Łukasz Kaleta (Senior Customer Success Manager) 5 years ago 6

We are implementing the Subscription API. From documentation we see that "Subscriptions are automatically removed if they do not work".

I can imagine that our custom application we are developing will not always available (ie planned maintenance, lost internet connection).

How can we see which subscription status changes are missed? Is there a log table in XTRF? Or is there a queue, where we can 'refire' the missed call from XTRF?


Issues with API since the upgrade

Michal Shinitzky 5 years ago in API 0


This question is for all those API developers:

Since the upgrade some function in our API code aren't working as they were:

1. Attach a file to a project/quote request.

2. New potential client - when we create a new potential client and then send the quote, we get a 403 error. Any idea why is this happening?

thank you in advance!


Searching answer

BIRT Eclipse report templates: how to add EU VAT number

Stan 6 years ago in API updated by Thierry ABAQUE 4 years ago 6


The dynamic fields corresponding to EU VAT disappeared in the new XTRF templates. While I can see a field with our company EU VAT –

(xtrfContext.getRootObject().getCustomer().getBranch().getCountrySpecificFiscalCodeValue() != "" ? reportContext.getMessage("pdf.eu_vat", reportContext.getLocale()) + " " + xtrfContext.getRootObject().getCustomer().getBranch().getCountrySpecificFiscalCodeValue() : "")

 – I would like to know there the XTRF BIRT expressions are stored. XTRF Knowledge base here at UserEcho seems not to cover this important issue.


API Timeout Issues After Upgrade to XTRF 7?

Cori Alcorn 6 years ago in API updated by Łukasz Kaleta (Senior Customer Success Manager) 6 years ago 7

Is anyone else having issues with API Timeouts after upgrade to XTRF 7? Several of our main integrations are now failing since our upgrade, and they are all /browser/csv calls that are trying to generate CSVs. When I look in the logs, it looks like an error is being thrown saying the max temporary file size has been exceeded. These are the same exact scripts that were running on XTRF 6 before the upgrade.

I have a ticket into XTRF, but just curious if anyone else has a) run into this since upgrading, b) got it resolved through XTRF support and c) if anyone has found a way to skip the CSV download and instead loop through the pages of the browser call and compile all of the rows into a json/CSV format directly?


Hi Cory, we use the API extensively. Since upgrading to XTRF 7, I didn't experience any of the said timeouts. We have been generating reports/csv reports with all our data, approx. 1500 entries. Though, it did seem to be not fully idem potent and the results varied on every refresh.

We came up with an other solution:

1. Send a CSV file every hour to my e-mail address with the Periodic Jobs (XTRF --> Settings --> Integrations --> Periodic Jobs). You can select any View you'd like.

2. Have an e-mail reader automatically read the e-mail and save the CSV into your database

3. Run a report on the CSV within your database


How do you add files to a task using the Home Portal API?

Mike MacKechnie 6 years ago in API updated by Łukasz Kaleta (Senior Customer Success Manager) 6 years ago 2

I'm looking to develop a process where our customer managers can upload 1 to many source files to tasks in an XTRF project, using the Home Portal API - my intention is to write the code to run server-side so that at a push of a button, multiple files can be uploaded.

We have daily project files that we create from a template - that bit's nice and simple; the files come in during the day from our client, and then at about 5 p.m. each evening all the files have to be uploaded to the project. This is currently time-consuming and open to human error.

Has anybody here faced a similar challenge, and if so, what did they do to resolve it?



Can I export a Smart View through the API?

mark 6 years ago in API updated by Łukasz Kaleta (Senior Customer Success Manager) 6 years ago 3

I'm struggling with this and would love some thoughts. 

I would like to connect through the API a smart view and dump it into a Google Sheet or Google BigQuery. I know that you can connect a smart view in Google DataStudio via the beta connector, and I thought I read on this forum (but can't find it now) that someone said you can export a smart view via the API. However, I can't find that in the API documentation.

Does anyone have any thoughts or ideas on this?



How do you create a new quote using the Home Portal API?

Mike MacKechnie 6 years ago in API updated by Jorge Villafuerte 2 years ago 20

I've searched the API documentation, and all the questions here, but I can't find an answer to the questions - how can I create a quote using the Home Portal API? I see lots of API's which can act on a known quote number, but what about if you have an incoming request which requires a quote to be created before the project can be created? We have a customer who has this requirement, and at the moment we are having to create projects via the API,  which we then "disguise" as quotes (basically by sticking the word Quote at the end of the project name).


Set Office by API?

Cori Alcorn 6 years ago in API updated by Łukasz Kaleta (Senior Customer Success Manager) 6 years ago 2

I have been working on an API integration and I have looked all over the documentation and all I see in the API is in the Customer API it allows one to list the offices, but it doesn't allow you to set a parent office ID or anything when you are creating a new Customer from the Home Portal API. Does anyone know if I am missing something and there is some way to set parent office of new or existing customers?