Skip to main content

Set Reference Fields

PUT 
/api/v1/connectors/:connector_id/reference-fields

Set an Odoo connector's config["reference_fields"] — and nothing else.

A dedicated endpoint because PATCH /connectors/{id} REPLACES config wholesale: sending {"config": {"reference_fields": …}} there would wipe the connection (instance_url, database, username, company_id), the parked register and the cursor's handled ids — the connector would stop polling and forget every held invoice. This one replaces the one key and keeps every other key as it is. Sending no target removes the setting.

What it maps is read from the next poll on; an invoice already sent keeps what it was sent with. A poll already running when it is set does not put the old setting back: the poller writes only its own keys.

400 for a field that can never be a reference, because it is filed with the Tax Authority: the portal's access_token and access_url, a name that marks a secret (token, password, secret) and one that names a person (partner_id, invoice_user_id, an email or phone field).

Request​

Responses​

Successful Response