Configuring Projuris ADV as a Source
In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the Projuris ADV option from the list of connectors. Click Next and you’ll be prompted to add your access.1. Add account access
Projuris authenticates with four values: an API client pair that identifies the integration, plus the login of a real Projuris user the extraction runs as. To get the API client pair, sign in as an account administrator and go to Perfil > Dados da Conta, then open the Integração tab. The Integração por API section shows the Client ID and the Client Secret — use the reveal button to read the secret in full, and the copy button next to each field.The extraction sees exactly what the configured user can see in Projuris — their organisational units, permission profiles and case access. A restricted user produces smaller tables and the run still succeeds, so the gap is easy to miss. Use a user with access to the whole operation.
-
Client ID: the API Client ID from Perfil > Dados da Conta > Integração. It looks like
api_cliente_codigo_12345. Required. - Client Secret: the API Client Secret from the same screen. Required.
- User Login: the login of the Projuris user the extraction runs as. Type only the login, without the office domain — the connector appends it for you. Required.
- User Password: the password of that user. If the user changes their password in Projuris, update it here too. Required.
-
Office Domain: your office domain, shown under Dados da Conta. It is the first part of the address you sign in at: for
sajadv.projurisadv.com.brthe domain issajadv. Required. - Start Date: the earliest date read by the two incremental tables, Cases and Case Timeline Entries. Leave it empty to extract the full history.
- Lookback Days: how many days are re-read before the last sync point on the incremental tables. Court captures frequently register timeline entries carrying an older date, and this window is what picks them up. Defaults to 7.
- Page Size: how many records are requested per page. Defaults to 100. Lower it if Projuris times out on very large pages.
- Requests Per Second: the maximum number of API calls per second this source makes. Projuris enforces a ceiling of 8 per second for the whole account, shared with every other integration using it. Defaults to 6.
2. Select streams
Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis. You can select entire groups of streams or pick specific ones.Tip: The stream can be found more easily by typing its name.Select the streams and click Next.
3. Configure data streams
Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a folder to organize it inside the layer, a name for each table (which will effectively contain the fetched data) and the type of sync.- Layer: choose between the existing layers on your catalog. This is where you will find your new extracted tables as the extraction runs successfully.
- Folder: a folder can be created inside the selected layer to group all tables being created from this new data source.
- Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix to all tables at once and make this process faster!
- Sync Type: Cases and Case Timeline Entries support incremental sync; every other table is full table. Read more about Sync Types here.
4. Configure data source
Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times). Optionally, you can define some additional settings:- Configure Delta Log Retention and determine for how long we should store old states of this table as it gets updated. Read more about this resource here.
- Determine when to execute an Additional Full Sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.
5. Check your new source
You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.How the extraction behaves
Only two tables sync incrementally, and that is a deliberate choice. Projuris lets you ask “what changed since” on Cases and Case Timeline Entries only. Every other endpoint filters on a business date — when the task was created, when the time was booked, when the publication was issued — so an edit made to an older record would never come back through such a filter. Those tables are re-read in full on each run instead of losing edits silently. People and Companies is the mirror case: its filter does accept “changed since”, but the records carry no modification timestamp to resume from, so it is full table as well. Court entries arrive late, and the lookback covers that. Automatic court captures routinely register timeline entries dated days earlier than the day they land. The Case Timeline Entries table therefore re-reads a trailing window before its last sync point, controlled by Lookback Days. Widen it if your courts are slow to publish. The rate limit is shared across your whole account. Projuris caps the API at 8 requests per second for the account, not per integration. The connector paces itself with Requests Per Second and, if Projuris throttles a run anyway, waits and retries instead of failing — the run simply takes longer. Lower the setting if other integrations use the same credentials. Dates and nested values are normalised. Projuris returns every date as a number of milliseconds; the connector converts them to proper timestamps and turns the platform’s “no date” placeholders into empty values instead of a bogus 1970 date. Fields that hold an object or a list of objects — responsible users, work groups, custom field values, financial line items — are extracted as JSON strings rather than nested columns. Row counts follow the user’s permissions. Every table reflects what the configured user is allowed to see. If a table looks smaller than expected, compare it against what that same user sees when signed into Projuris.Troubleshooting
The Integração tab does not appear in Dados da Conta
The Integração tab does not appear in Dados da Conta
Two conditions must both hold: you are signed in with an administrator profile, and the API module is contracted on your plan. The API is a paid add-on in Projuris ADV. Check with whoever manages the account, and if it is not contracted, talk to your Projuris commercial contact.
The run fails saying the credentials were rejected
The run fails saying the credentials were rejected
Check each of the five values in order. The Client ID and Client Secret must be the current pair in Perfil > Dados da Conta > Integração — if anyone clicked Gerar nova chave, the old secret died instantly and has to be replaced here. The User Login must be typed without the office domain. The User Password must be the one that user currently signs in with. The Office Domain is the first part of your sign-in address, not your company name.
A table came back empty or smaller than expected
A table came back empty or smaller than expected
Results always respect the permissions of the user configured on the source — their organisational units, permission profiles and case access. Sign into Projuris as that same user and compare what they can see. If they cannot reach part of the operation, either widen their permissions or point the source at a user who can.
Recent edits are missing from a table
Recent edits are missing from a table
Cases and Case Timeline Entries sync incrementally. Everything else is full table and will show the edit on the next run. If an edited case is missing, check that its modification date really moved in Projuris; if a timeline entry is missing, raise Lookback Days so the trailing window covers how late your courts publish.
The run is much slower than usual
The run is much slower than usual
Check whether Case Parties is selected: it makes one API call per case and is by far the most expensive table. Also check whether other integrations are sharing your account’s 8 requests per second — if so, lower Requests Per Second so this source paces itself steadily rather than being throttled.
The run log says Projuris is limiting how fast data is read
The run log says Projuris is limiting how fast data is read
Your account reached its 8 requests per second ceiling. The connector waits and retries automatically, so no data is lost and no action is needed. If it happens on every run, lower Requests Per Second in the source settings, or check which other integrations are consuming the same allowance.
Streams and Fields
Below you’ll find all available data streams from Projuris ADV and their corresponding fields. API reference: Projuris ADV API documentation.Cases
Cases
Every lawsuit and extrajudicial matter the office handles (
POST /processo/consulta). This is the central table the rest of the model hangs off.Primary key: codigo_processoReplication key: data_ultima_modificacaoCase Parties
Case Parties
The parties linked to each case — clients, opposing parties and third parties — read per case (
GET /processo/envolvido/.../consulta). One API call per case returned by the Cases table.Primary key: codigo_processo, codigo_vinculo_envolvidoCase Timeline Entries
Case Timeline Entries
Timeline entries recorded against cases and attendances (
POST /andamento/consulta-geral), including entries captured automatically from the courts. Normally the largest table in the account.Primary key: codigo_andamentoReplication key: data_andamentoPeople and Companies
People and Companies
The office’s address book: clients, opposing parties and every other contact (
POST /pessoa/consulta).Primary key: codigo_pessoaAttendances
Attendances
Consultations and non-litigious matters (
POST /atendimento/consulta).Primary key: codigo_atendimentoTasks and Appointments
Tasks and Appointments
Tasks, deadlines and calendar appointments (
POST /tarefa/consulta-com-paginacao).Primary key: codigo_tarefaTime Entries
Time Entries
Billable time booked against cases and attendances (
POST /apontamento-horas/consulta).Primary key: codigo_apontamento_horasFee Agreements
Fee Agreements
Fee agreements linking clients to the matters the office bills them for (
POST /contrato/consulta).Primary key: codigo_contratoCourt Publications
Court Publications
Official court publications captured against the office’s bar registrations (
GET /intimacao/consulta).Primary key: codigo_intimacaoRevenue and Expenses
Revenue and Expenses
Revenue and expense entries from the financial module (
POST /receita-despesa/consulta).Primary key: codigo_receita_despesaUsers
Users
Users of the Projuris ADV account (
GET /usuario/consulta).Primary key: codigo_usuarioTimeline Entry Types
Timeline Entry Types
Lookup table of the types available for timeline entries (
GET /andamento-tipo/consulta).Primary key: codigo_andamento_tipoTask Types
Task Types
Lookup table of the types available for tasks and appointments (
GET /tarefa-tipo/consulta).Primary key: codigo_tarefa_tipoTime Entry Types
Time Entry Types
Lookup table of the types available for billable time, including their default hourly rate (
GET /apontamento-hora-tipo/consulta).Primary key: codigo_tipo_apontamento_horaCost Centres
Cost Centres
Lookup table of the cost centres configured in the financial module (
GET /financeiro/centro-custo/consulta).Primary key: codigo_centro_custoFinancial Accounts
Financial Accounts
Lookup table of the bank and cash accounts configured in the financial module (
GET /financeiro/conta/consulta).Primary key: codigo_contaChart of Accounts
Chart of Accounts
Lookup table of the chart of accounts used by the financial module (
GET /financeiro/plano-conta/consulta).Primary key: codigo_plano_conta