99

Integração com a 99 Corporate API para gerenciar empresas, centros de custo, projetos, funcionários, corridas, recibos e webhooks.

Authentication

This connector uses Token-based authentication.

info

Set up your connection in the Abstra Console before using it in your workflows.

How to use

Using the Smart Chat

Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".

Using the Web Editor

from abstra.connectors import run_connection_action

result = run_connection_action(
  connection_name="your_connection_name",
  action_name="your_action_name",
  params={
    "param1": "value1",
    "param2": "value2"
  })

Available Actions

This connector provides 72 actions:

Action	Purpose	Parameters
get_companies	List all companies authorized to you	No parameters
put_companies_disable	Disable project required for company	No parameters
get_companies_emails	List all emails of those responsible for company	No parameters
put_companies_emails	Update emails of those responsible for company	data (array) required
put_companies_enable	Enable project required for company	No parameters
get_companies_justification	Find justification	No parameters
put_companies_justification	Update justification	data: { . companyId (integer) . justificationRequired (boolean) . maxLength (integer) . minLength (integer) } (object) required
get_companies_receipt_email	Find receipt email configuration	No parameters
put_companies_receipt_email	Update receipt email configuration	data (boolean) required
get_costcenters	List cost centers of your company	limit (string) page (string) search (string)
post_costcenters	Create a cost center	data: { . name (string) } (object) required
get_costcenters_by_id	Find a cost center by ID	id (string)
delete_costcenters_by_id	Remove cost center reference	id (string)
get_costcenters_by_id_owners	Find Cost center's owner	id (string)
put_costcenters_by_id_owners	Update cost center's owner	id (string) data (array) required
get_employees	List employees of your company	limit (string) nationalId (string) page (string) search (string)
post_employees	Create an employee	data: { . employee (object) . sendWelcomeEmail (boolean) } (object) required
post_employees_external_id	Create an employee by external id	data: { . employee (object) . sendWelcomeEmail (boolean) } (object)
get_employees_external_id_by_external_id	Find employees by external id	externalId (string)
delete_employees_external_id_by_external_id	Disable employees by external id	externalId (string)
get_employees_external_id_by_external_id_costcenter	List employees cost centers by external id	externalId (string)
patch_employees_external_id_by_external_id_costcenter	Update employees cost center references by external id	externalId (string) data: { . costCenterIDs (array) } (object) required
delete_employees_external_id_by_external_id_costcenter_by_cost_center_id	Remove employees cost center reference by external id	costCenterId (string) externalId (string)
get_employees_external_id_by_external_id_policy	Get employees policy by external id	externalId (string)
put_employees_external_id_by_external_id_policy	Update policy for the employees by external id	externalId (string) data: { . budget (object) . rideCredit (object) } (object) required
delete_employees_external_id_by_external_id_policy	Remove policy for employees by external id	externalId (string)
delete_employees_external_id_by_external_id_supervisor	Remove supervisor from employees by external id	externalId (string)
put_employees_external_id_by_external_id_by_phone	Update employees by external id and phone	externalId (string) phone (string) data: { . employee (object) . sendWelcomeEmail (boolean) } (object)
post_employees_by_employee_id_agreement	Employee accepts agreement	employeeId (string) data: { . term (object) } (object) required
get_employees_by_employee_id_costcenter	List employee cost centers	employeeId (string)
patch_employees_by_employee_id_costcenter	Update employee cost center references	employeeId (string) data: { . costCenterIDs (array) } (object)
delete_employees_by_employee_id_costcenter_by_cost_center_id	Remove employee cost center reference	costCenterId (string) employeeId (string)
get_employees_by_employee_id_policy	Get policy from employee	employeeId (string)
put_employees_by_employee_id_policy	Update policy for the employee	employeeId (string) data: { . budget (object) . rideCredit (object) } (object) required
delete_employees_by_employee_id_policy	Remove policy for employee	employeeId (string)
get_employees_by_id	Find an employee by ID	id (string)
put_employees_by_id	Update an employee	id (string) data: { . employee (object) . sendWelcomeEmail (boolean) } (object)
delete_employees_by_id	Disable an employee	id (string)
delete_employees_by_id_supervisor	Remove supervisor from employee	id (string)
get_projects	List projects of your company	limit (string) page (string) search (string)
post_projects	Create an project	data: { . name (string) } (object) required
get_projects_by_id	Find an project by ID	id (string)
put_projects_by_id	Update an project	id (string) data: { . name (string) } (object) required
delete_projects_by_id	Disable an project	id (string)
get_receipts	List receipts by filters	costCenterId (string) endDate (string) required limit (string) page (string) projectId (string) startDate (string) required taxiCategory (string)
get_receipts_receipt_id_by_receipt_id	Get a receipt by Receipt Id	receiptId (string)
get_receipts_by_ride_id	Get a receipt by Ride Id	rideId (string)
get_rides	Get the running ride status with optional filter by phone	phone (string)
post_rides	Book a ride	data: { . categoryID (string) . categoryIds (array) . costCenterID (integer) . employeeID (integer) . from (object) . notes (string) . optionals (array) . phoneNumber (string) . projectID (integer) . receiver (object) . to } (object) required
get_rides_estimate_by_employee_id	Find estimate ride by employee id	employeeId (string) fromAddress (string) fromLat (string) fromLng (string) toAddress (string) toLat (string) toLng (string)
get_rides_update_estimate_by_ride_id	Estimate a update ride	rideId (string) toAddress (string) toLat (string) required toLng (string) required
get_rides_by_id	Get the running ride status by id	id (string)
delete_rides_by_id	Cancel a ride by id	id (string)
patch_rides_by_ride_id	Update a ride	rideId (string) data: { . notes (string) . to (object) } (object) required
get_timepolicies	List all time policies	limit (string) page (string)
post_timepolicies	Create a Time Policy	data: { . description (string) . intervals (array) . name (string) } (object) required
get_timepolicies_by_id	Find a Time Policy	id (string)
put_timepolicies_by_id	Update a Time Policy	id (string) data: { . description (string) . intervals (array) . name (string) } (object) required
delete_timepolicies_by_id	Disable a Time Policy	id (string)
get_timepolicies_by_time_policy_id_costcenter	List Cost Centers using the time policy	timePolicyId (string)
patch_timepolicies_by_time_policy_id_costcenter	Update Cost Centers using the Time Policy	timePolicyId (string) data (array) required
delete_timepolicies_by_time_policy_id_costcenter_by_cost_center_id	Cost center stop to use the Time Policy	costCenterId (string) timePolicyId (string)
get_users	List users of company	limit (string) page (string)
post_users	Create an User	data: { . email (string) . name (string) } (object) required
delete_users	Remove user	email (string) required
put_users_admin	Update to Corporate User	email (string) required
delete_users_admin	Update to Corporate User	email (string) required
put_users_profile	Update profile for user	data: { . email (string) . profile (string) } (object) required
get_webhook	Get webhook configuration	No parameters
put_webhook	Update webhook configuration	data: { . authentication (object) . id (string) . subscriptions (array) . url (string) } (object) required
delete_webhook	Delete webhook configuration	No parameters
custom	Call any endpoint of the connected service while reusing the connection auth. Pass the full URL as _url. Other reserved keys: _method, _query, _body, _headers. Remaining params flow naturally — empty → GET, non-empty → POST JSON body.	_url (string) required _method (string) _query (object) _body _headers (object)

Webhook Events

This connector emits 2 events back to your workflow. To receive one, create a hook whose path is <connection-name>/<event> — the connection name you configured plus the event from the table below.

Event	Description
ride-status	Ocorre quando o status de uma corrida muda criada, aceita, concluída, etc..
ride-driver-location	Ocorre quando a localização do motorista de uma corrida em andamento é atualizada.