Skip to main content
Projuris ADV is a Brazilian legal practice management platform used by law firms and corporate legal departments to run their caseload: lawsuits and their court timelines, clients and opposing parties, consultations, deadlines and appointments, billable time, fee agreements, court publications captured automatically from the courts, and the office’s financial ledger. The connector extracts all of it, so you can analyse caseload, productivity, billing and cash in your Lakehouse.
The Projuris ADV API is a paid add-on, not part of every plan. If the Integração tab described below is missing, the API module is not contracted on your account — talk to your Projuris commercial contact before setting this source up.

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.
Clicking Gerar nova chave in Projuris invalidates the current Client Secret immediately. Any integration still using the old secret stops authenticating until it is updated, this source included.
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.
The following configurations are available:
  • 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.br the domain is sajadv. 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.
Once you’re done, click Next.

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.
Case Parties is read one API call per case. On an office with tens of thousands of cases it dominates the run time. Select it only if you need the party breakdown, and consider putting it in a separate source with a less frequent trigger.
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.
Once you are done configuring, click Next.

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.
Once you are ready, click Next to finalize the setup.

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.
For you to be able to see it on your Catalog, you need at least one successful source run.

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

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.
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.
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.
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.
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.
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.
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_modificacao
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_envolvido
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_andamento
The office’s address book: clients, opposing parties and every other contact (POST /pessoa/consulta).Primary key: codigo_pessoa
Consultations and non-litigious matters (POST /atendimento/consulta).Primary key: codigo_atendimento
Tasks, deadlines and calendar appointments (POST /tarefa/consulta-com-paginacao).Primary key: codigo_tarefa
Billable time booked against cases and attendances (POST /apontamento-horas/consulta).Primary key: codigo_apontamento_horas
Fee agreements linking clients to the matters the office bills them for (POST /contrato/consulta).Primary key: codigo_contrato
Official court publications captured against the office’s bar registrations (GET /intimacao/consulta).Primary key: codigo_intimacao
Revenue and expense entries from the financial module (POST /receita-despesa/consulta).Primary key: codigo_receita_despesa
Users of the Projuris ADV account (GET /usuario/consulta).Primary key: codigo_usuario
Lookup table of the types available for timeline entries (GET /andamento-tipo/consulta).Primary key: codigo_andamento_tipo
Lookup table of the types available for tasks and appointments (GET /tarefa-tipo/consulta).Primary key: codigo_tarefa_tipo
Lookup table of the types available for billable time, including their default hourly rate (GET /apontamento-hora-tipo/consulta).Primary key: codigo_tipo_apontamento_hora
Lookup table of the cost centres configured in the financial module (GET /financeiro/centro-custo/consulta).Primary key: codigo_centro_custo
Lookup table of the bank and cash accounts configured in the financial module (GET /financeiro/conta/consulta).Primary key: codigo_conta
Lookup table of the chart of accounts used by the financial module (GET /financeiro/plano-conta/consulta).Primary key: codigo_plano_conta