Pular para o conteúdo principal

Remessa, retorno e EDI

O ciclo CNAB do boleto — registros, remessas e retornos —, as remessas de pagamento e as caixas EDI que recebem os arquivos do banco.

Famílias nesta página​

FamíliaToolsreadwritedestructive
Registros de boleto2200
Remessas CNAB4202
Boletos em remessa3201
Retornos CNAB2200
Boletos em retorno2200
Remessas de pagamento1100
Caixas EDI4202

Registros de boleto​

Escopo: banking/charge.bank_billet_registrations

ToolTipoPermissãoEspelhaO que faz
banking_charge_bank_billet_registration_listreadcharge.cnabs.basicGET /v2/charge/bank_billet_registrationsLists the registration attempts of the account's bank billets at the bank (registro via API), most recent first, with their status, failures and error message.
banking_charge_bank_billet_registration_getreadcharge.cnabs.basicGET /v2/charge/bank_billet_registrations/:uidReturns one registration attempt of a bank billet at the bank, with its status, failure count and error message, in the same shape as the API v2.

Remessas CNAB​

Escopo: banking/integration.remittances

ToolTipoPermissãoEspelhaO que faz
banking_charge_remittance_listreadcharge.cnabs.basicGET /v2/charge/remittancesLists the CNAB remittance files (arquivos de remessa) of the account, most recent first, with their status and whether they were sent to the bank.
banking_charge_remittance_getreadcharge.cnabs.basicGET /v2/charge/remittances/:uidReturns one CNAB remittance file (arquivo de remessa) with its status, download URL once processed, and every billet instruction it carries, in the same shape as the API v2.
banking_charge_remittance_createdestructivecharge.cnabs.createPOST /v2/charge/remittancesGenerates CNAB remittance files (arquivos de remessa) with the pending billet instructions (see banking_charge_bank_billet_remittance_list): all of a bank billet account (bank_billet_account_uid, up to 3000), or only the given bank_billet_remittance_uids (one file per bank billet account they belong to).
banking_charge_remittance_deletedestructivecharge.cnabs.destroyDELETE /v2/charge/remittances/:uidDeletes a CNAB remittance file.

Boletos em remessa​

Escopo: banking/integration.remittances

ToolTipoPermissãoEspelhaO que faz
banking_charge_bank_billet_remittance_listreadcharge.cnabs.basicGET /v2/charge/bank_billet_remittancesLists the CNAB remittance instructions (occurrences such as registration, due date change or write-off) of the account's bank billets, most recent first.
banking_charge_bank_billet_remittance_getreadcharge.cnabs.basicGET /v2/charge/bank_billet_remittances/:uidReturns one CNAB remittance instruction of a bank billet, with its occurrence and the remittance file it went into, in the same shape as the API v2.
banking_charge_bank_billet_remittance_deletedestructivecharge.cnabs.destroyDELETE /v2/charge/bank_billet_remittances/:uidRemoves a pending CNAB remittance instruction of a bank billet, so it is not sent to the bank in the next remittance file.

Retornos CNAB​

Escopo: banking/integration.discharges

ToolTipoPermissãoEspelhaO que faz
banking_charge_discharge_listreadcharge.cnabs.basicGET /v2/charge/dischargesLists the CNAB return files (arquivos de retorno) the account received from its banks, most recent first, with their processing status.
banking_charge_discharge_getreadcharge.cnabs.basicGET /v2/charge/discharges/:uidReturns one CNAB return file (arquivo de retorno) with its processing status and every occurrence it reported for the bank billets, in the same shape as the API v2.

Boletos em retorno​

Escopo: banking/integration.discharges

ToolTipoPermissãoEspelhaO que faz
banking_charge_bank_billet_discharge_listreadcharge.cnabs.basicGET /v2/charge/bank_billet_dischargesLists the occurrences that CNAB return files (arquivos de retorno) reported for the account's bank billets (registration confirmed, paid, rejected...), most recent first.
banking_charge_bank_billet_discharge_getreadcharge.cnabs.basicGET /v2/charge/bank_billet_discharges/:uidReturns one occurrence a CNAB return file reported for a bank billet, with its meaning, error detail and the raw and parsed file line, in the same shape as the API v2.

Remessas de pagamento​

Escopo: banking/integration.remittances

ToolTipoPermissãoEspelhaO que faz
banking_remittance_payment_getreadintegration.remittances.basicGET /v2/remittance/payments/:uidReturns one payment remittance (CNAB file of payments sent to the bank) of the account: file name, status, number, the financial account it belongs to and, once processed, a download link.

Caixas EDI​

Escopo: banking/integration.edi_boxes

ToolTipoPermissãoEspelhaO que faz
banking_edi_edi_box_listreadintegration.edi_boxes.basicGET /v2/edi/edi_boxesLists the EDI boxes (CNAB file channels with the banks) of the account, most recent first, with filters that combine.
banking_edi_edi_box_getreadintegration.edi_boxes.basicGET /v2/edi/edi_boxes/:uidReturns one EDI box of the account: its account, layout, people, authorization letter status and activation status at the bank, plus a download link for the letter (valid for 48 hours).
banking_edi_edi_box_createdestructiveintegration.edi_boxes.createPOST /v2/edi/edi_boxesCreates an EDI box: the channel through which CNAB files (remittances and returns) of a billet wallet or financial account are exchanged with the bank through a VAN.
banking_edi_edi_box_updatedestructiveintegration.edi_boxes.updatePUT /v2/edi/edi_boxes/:uidChanges the fields given of one EDI box (name, layout, people, account); fields left out keep their value.

Os campos de cada recurso estão na Referência da API. Uma tool que você não pode rodar não aparece em tools/list; se uma daqui não está lá, veja Autenticação.