> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Retomar o Poller de TED IN > Use este endpoint para liberar a trava de recebimento fail-closed at-most-once e rearmar um poller de TED IN travado ou morto sem reiniciar o pod. Este é um endpoint de operador de privilégio mais elevado que `/ted-in/poll`, pois ele reabre o consumo destrutivo de leitura do JD. Recorra a ele somente quando a auto-recuperação não conseguir reviver o poller — um filho multi-tenant em pânico ou um poller single-tenant além do limite rígido de pânico. A retomada nunca ignora o portão durável de lacunas do caminho do dinheiro. Quando a trava live receive-state-unknown está ativa, a linha da lacuna de reconciliação da trava atual precisa estar durável antes de o poller retomar; caso contrário, a requisição é recusada com `409` e o poller permanece morto. Verifique a lacuna pendente com [Listar Lacunas de Reconciliação de TED IN](/pt/reference/midaz/plugins/ted/list-ted-in-reconciliation-gaps) antes de chamar a retomada. O corpo opcional `{acknowledge, note}` adicionalmente marca a lacuna de reconciliação da trava atual como resolvida e carimba uma anotação de operador nela. `acknowledge` tem valor padrão `false`, deixando a lacuna ABERTA para permanecer visível para revisão. Um poller saudável e não travado retorna `200` com `resumed: false` e `reason: "not_latched"` — a chamada é um no-op idempotente e seguro. Retentativas com a mesma chave replicam a resposta em cache. A rota é independente de organização e não requer o cabeçalho `X-Organization-Id` — o tenant é resolvido a partir do contexto autenticado. Em implantações multi-tenant, um tenant inativo é rejeitado com `503`. ## OpenAPI ````yaml pt/openapi/v3-current/ted.yaml post /v1/transfers/ted-in/resume openapi: 3.0.3 info: title: API do Plugin de Transferência Bancária (TED) description: >- API completa para transferências bancárias brasileiras (TED OUT, TED IN, P2P) através da plataforma Lerian, incluindo iniciação de transferências, processamento, acompanhamento de status e cancelamento. version: 1.1.9 servers: - url: https://ted.sandbox.lerian.net description: Sandbox (placeholder — ainda não disponível para acesso público) security: - BearerAuth: [] - OAuth2ClientCredentials: - api - OAuth2Password: - api tags: - name: Transfers API description: Endpoints para iniciar, processar, acompanhar e cancelar transferências. - name: Webhooks description: >- Endpoints para registrar e gerenciar assinaturas de webhook com escopo de tenant para eventos de transferência. - name: Webhook DLQ description: >- Endpoints para inspecionar e reprocessar mensagens da dead-letter queue de webhooks. paths: /v1/transfers/ted-in/resume: post: tags: - Transfers API summary: Retomar o Poller de TED IN description: >- Use este endpoint para liberar a trava de recebimento fail-closed at-most-once e rearmar um poller de TED IN travado ou morto sem reiniciar o pod. Este é um endpoint de operador de privilégio mais elevado que `/ted-in/poll`, pois ele reabre o consumo destrutivo de leitura do JD. Recorra a ele somente quando a auto-recuperação não conseguir reviver o poller — um filho multi-tenant em pânico ou um poller single-tenant além do limite rígido de pânico. A retomada nunca ignora o portão durável de lacunas do caminho do dinheiro. Quando a trava live receive-state-unknown está ativa, a linha da lacuna de reconciliação da trava atual precisa estar durável antes de o poller retomar; caso contrário, a requisição é recusada com `409` e o poller permanece morto. Verifique a lacuna pendente com [Listar Lacunas de Reconciliação de TED IN](/pt/reference/midaz/plugins/ted/list-ted-in-reconciliation-gaps) antes de chamar a retomada. O corpo opcional `{acknowledge, note}` adicionalmente marca a lacuna de reconciliação da trava atual como resolvida e carimba uma anotação de operador nela. `acknowledge` tem valor padrão `false`, deixando a lacuna ABERTA para permanecer visível para revisão. Um poller saudável e não travado retorna `200` com `resumed: false` e `reason: "not_latched"` — a chamada é um no-op idempotente e seguro. Retentativas com a mesma chave replicam a resposta em cache. A rota é independente de organização e não requer o cabeçalho `X-Organization-Id` — o tenant é resolvido a partir do contexto autenticado. Em implantações multi-tenant, um tenant inativo é rejeitado com `503`. operationId: resumeTEDInPoller parameters: - $ref: '#/components/parameters/XIdempotencyKey' requestBody: required: false description: >- Opções opcionais de retomada. Um corpo vazio rearma o poller e mantém a lacuna de reconciliação aberta. content: application/json: schema: $ref: '#/components/schemas/TEDInResumeRequest' examples: rearmOnly: summary: Rearmar o poller, deixar a lacuna aberta value: {} acknowledgeGap: summary: Rearmar e marcar a lacuna atual como resolvida value: acknowledge: true note: verified against the JD cabine; no inbound message lost responses: '200': description: >- Indica que a tentativa de retomada foi concluída. `resumed` é `true` quando um poller travado ou morto foi rearmado e `false` para o no-op saudável. `gapResolved` é `true` somente quando `acknowledge` foi solicitado E a linha da lacuna foi marcada com sucesso como resolvida. `reason` é o estado do qual foi retomado (`receive_state_unknown`, `panic`, `auth_failure`) ou `not_latched` para o no-op. content: application/json: schema: $ref: '#/components/schemas/TEDInResumeResponse' examples: resumed: summary: Poller travado rearmado value: resumed: true gapResolved: false reason: receive_state_unknown tenantId: 11111111-1111-1111-1111-111111111111 notLatched: summary: No-op saudável value: resumed: false gapResolved: false reason: not_latched '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '409': description: >- Retomada recusada. A trava receive-state-unknown ainda não possui uma lacuna de reconciliação durável, portanto o poller permanece morto. Tente novamente após a linha da lacuna ser persistida. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': $ref: '#/components/responses/RateLimitExceeded' '500': $ref: '#/components/responses/InternalServerError' '503': $ref: '#/components/responses/ServiceUnavailable' '504': $ref: '#/components/responses/GatewayTimeout' components: parameters: XIdempotencyKey: name: X-Idempotency in: header required: true description: >- Chave de idempotência obrigatória para tentativas seguras. Use um UUID v4 ou identificador de negócio único. Se a mesma chave for enviada novamente e a solicitação original já tiver sido processada, a resposta em cache será retornada. Consulte [Tentativas e idempotência](/pt/reference/retries-idempotency) para detalhes. schema: type: string maxLength: 255 example: 019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b schemas: TEDInResumeRequest: type: object description: >- Corpo opcional para uma retomada do poller de TED IN. Todos os campos são opcionais; um corpo vazio rearma o poller e mantém a lacuna de reconciliação aberta. properties: acknowledge: type: boolean default: false description: >- Quando `true`, marca a lacuna de reconciliação da trava atual como resolvida após o poller ser rearmado. O valor padrão é `false` para que a lacuna permaneça ABERTA e continue visível para revisão. example: false note: type: string maxLength: 500 description: >- Anotação de operador carimbada na lacuna resolvida quando `acknowledge` é `true`. Ignorada caso contrário. example: verified against the JD cabine; no inbound message lost TEDInResumeResponse: type: object required: - resumed - gapResolved - reason properties: resumed: type: boolean description: >- `true` quando um poller travado ou morto foi rearmado; `false` para o no-op saudável. example: true gapResolved: type: boolean description: >- `true` somente quando `acknowledge` foi solicitado E a linha da lacuna foi marcada com sucesso como resolvida. example: false reason: type: string enum: - receive_state_unknown - panic - auth_failure - not_latched description: >- O estado do poller do qual foi retomado. `not_latched` indica o no-op idempotente. example: receive_state_unknown tenantId: type: string format: uuid description: >- Identificador do tenant resolvido. Omitido em implantações single-tenant. example: 11111111-1111-1111-1111-111111111111 ErrorResponse: type: object required: - error properties: error: type: object required: - code - service - category - message - requestId properties: code: type: string description: >- O código de erro estável. Erros do plugin usam o formato `BTF-XXXX`; rejeições de negócio/autenticação do JD SPB repassam o código bruto do fornecedor literalmente (por exemplo, `AAC90`, `ACE95`, `DVE01`), e falhas de transporte no nível do JD expõem os marcadores sintéticos `TRANSPORT` ou `JD_MISSING_CODE`. Faça a correspondência com base neste valor, e não no status HTTP. example: BTF-0010 service: type: string description: O serviço ou domínio que produziu o erro. example: plugin category: type: string description: >- Categoria de erro legível por máquina usada para decisões de reprocessamento. enum: - deterministic - transient - rate_limit - plugin example: deterministic message: type: string description: Um resumo do erro legível por humanos. example: >- Transferências só podem ser iniciadas de segunda a sexta entre 06:30 e 17:00 horário de Brasília requestId: type: string description: O ID de correlação da requisição. Presente mesmo quando vazio. example: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f fields: type: object additionalProperties: true description: >- Metadados estruturados de validação ou reprocessamento quando disponíveis. Detalhes de validação em nível de campo, cabeçalho, caminho e consulta são todos retornados aqui. example: currentTime: '2026-02-01T18:30:00-03:00' operatingHours: Mon-Fri 06:30-17:00 UTC-3 responses: BadRequest: description: >- Indica que a requisição contém entrada inválida. Verifique os detalhes do campo para erros de validação específicos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidInput: summary: Validation error value: error: code: BTF-0001 service: plugin category: deterministic message: >- The request contains invalid fields. Check the field details below. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f fields: recipientIspb: must be 8 digits amount: must be positive Unauthorized: description: Indica que a requisição não possui um token de autenticação válido. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: summary: Missing authorization value: error: code: BTF-0401 service: plugin category: deterministic message: Missing or invalid authentication token requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f Forbidden: description: >- Indica que o chamador está autenticado mas não tem permissão para esta operação, ou o tenant não está licenciado para este endpoint. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: notLicensed: summary: Tenant not licensed value: error: code: BTF-0403 service: plugin category: deterministic message: Tenant is not licensed to use this endpoint requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f permissionDenied: summary: Caller lacks permission value: error: code: BTF-0405 service: plugin category: deterministic message: Caller lacks permission for this resource requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f RateLimitExceeded: description: >- Indica que o limite de requisições foi excedido. Tente novamente após o número de segundos especificado no cabeçalho Retry-After. headers: Retry-After: description: Segundos até o limite de requisições ser redefinido schema: type: integer example: 60 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rateLimitExceeded: summary: Too many requests value: error: code: BTF-0429 service: plugin category: rate_limit message: >- Too many requests. Retry after the interval indicated by the `Retry-After` header. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f description: > As respostas de rate-limit usam o código dedicado `BTF-0429` com a categoria `rate_limit`. Os clientes devem aplicar backoff usando o status HTTP `429` e o cabeçalho `Retry-After`. InternalServerError: description: Indica que ocorreu um erro interno inesperado. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: internalError: summary: Internal error value: error: code: BTF-9000 service: plugin category: plugin message: Unexpected error while processing the request requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f ServiceUnavailable: description: >- Indica que um serviço externo (CRM, JD SPB, Midaz ou Fees) está temporariamente indisponível. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: crmUnavailable: summary: CRM service down value: error: code: BTF-0502 service: crm category: transient message: >- Unable to validate account. The CRM service is temporarily unavailable. Try again later. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f jdUnavailable: summary: JD SPB unavailable value: error: code: TRANSPORT service: jd_spb category: transient message: >- Unable to submit transfer. The JD SPB service is temporarily unavailable. Try again later. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f midazUnavailable: summary: Midaz ledger unavailable value: error: code: BTF-2000 service: midaz category: transient message: >- Unable to process transfer. The Midaz ledger service is temporarily unavailable. Try again later. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f feeServiceUnavailable: summary: Fee service unavailable (fail-closed mode) value: error: code: BTF-3000 service: fees category: transient message: >- Unable to calculate fee. The fee service is temporarily unavailable. Try again later. requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f dlqInspectorUnavailable: summary: DLQ inspector not configured value: error: code: BTF-9005 service: plugin category: deterministic message: DLQ inspector is not configured requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f GatewayTimeout: description: >- Indica que a operação upstream não foi concluída antes do deadline da requisição. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: timeout: summary: Drain exceeded deadline value: error: code: BTF-9000 service: plugin category: plugin message: 'trigger ted in poller: request timed out' requestId: 6d3e2a68-1f2b-4c3d-9e4f-5a6b7c8d9e0f securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Autenticação por token JWT Bearer. O tenantId é derivado do token bearer ou do contexto de requisição autenticado e não é fornecido por meio do X-Organization-Id. OAuth2ClientCredentials: type: oauth2 flows: clientCredentials: tokenUrl: /v1/login/oauth/access_token scopes: api: Acesso à API de transferências TED OAuth2Password: type: oauth2 flows: password: tokenUrl: /v1/login/oauth/access_token scopes: api: Acesso à API de transferências TED ````