Appoint the tenant's extraordinary-collection agent
Points this tenant at the collection agent it instructs, or switches the channel off. It is the act every other behaviour of the channel depends on: with no active agent, borrower collections stay PARKED in requested and are only counted. The agent name and account are stamped verbatim on every instruction and the Arquivo de Baixa Extraordinária quotes them back byte-exactly, so the shapes are refused here by name rather than by a database constraint. Each call writes handlesWithdrawal, false when absent; active: false parks issuance again WITHOUT deleting the identity an already issued instruction names. Because the identity travels in the SAME call as the on/off switch, a CHANGED name or account is refused with 409 while the current agent still has open instructions: it would abandon them, since the work queue matches the active channel byte-exactly against what each instrument was stamped with. Turn those instructions over first, then the switch goes through. Idempotent via the X-Idempotency header enforced by the platform middleware.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Canonical idempotency request ID. Required: this request moves money, and without a key a retry cannot be told apart from a second instruction.
Corpo
The collection agent's own receiving account, held at the agent and never an account of the lender's: the agent receives the borrower's cash and the lender ingests the settlement file. It becomes the payment identity of every settlement of the instructions it stamps, so it admits no colon, whitespace or control character — "conta byx 001" is refused here, where a 422 costs nothing, instead of stranding a paid borrower's money later.
1 - 255^[^\s:\x00-\x1f\x7f]+$The collection agent, lowercase authority shape. It is stamped VERBATIM on every instruction and the baixa file quotes it back byte-exactly, so mixed case would issue instructions no file could answer.
1 - 100^[a-z0-9][a-z0-9._-]{0,99}$Defaults to true. False turns the channel OFF without deleting the agent's identity, returning issuance to the park; an instrument already issued still names the agent that received it.
Defaults to false on every appointment. True is the operador's word that this agent withdraws (baixa) a boleto when it receives collection.instruction.withdrawn, and that the Streaming Hub subscription feeding it carries collection_instruction.withdrawn. Only then does Lender withdraw a boleto this agent holds once the instalment is credited another way, and issue what the portador still owes as a new instruction; while false every boleto it holds stands.
Resposta
OK
True while the channel instructs; false parks issuance.
The agent's receiving account.
The appointed collection agent.
True while Lender withdraws a boleto this agent holds through collection.instruction.withdrawn.

