> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pepper.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar código de rastreio (Lote)

> Atualiza o código de rastreio de múltiplas transações em uma única requisição (até 50 por vez).



## OpenAPI

````yaml POST /transactions/tracking/batch
openapi: 3.1.0
info:
  title: Pepper API v1
  description: Documentação da API pública da Pepper.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.cloud.pepperpay.com.br/public/v1/
security:
  - bearerAuth: []
paths:
  /transactions/tracking/batch:
    post:
      description: >-
        Atualiza o código de rastreio de múltiplas transações em uma única
        requisição (até 50 por vez).
      requestBody:
        description: Dados para atualização em lote dos códigos de rastreio
        content:
          application/json:
            schema:
              type: object
              required:
                - transactions
              properties:
                transactions:
                  type: array
                  description: Lista de objetos, cada um com os campos abaixo.
                  minItems: 1
                  maxItems: 50
                  items:
                    type: object
                    required:
                      - hash
                      - tracking_code
                    properties:
                      hash:
                        type: string
                        description: Hash da transação
                      tracking_code:
                        type: string
                        description: Código de rastreio
                        minLength: 1
                        maxLength: 255
                      carrier:
                        type: string
                        description: Transportadora
                        enum:
                          - correios
                          - jadlog
                          - total
                          - azul
                          - loggi
                          - melhor_envio
                          - megatransporte
                          - other
                      tracking_url:
                        type: string
                        format: uri
                        description: >-
                          Obrigatório somente quando carrier = other. Link de
                          rastreamento customizado.
                send_email:
                  type: boolean
                  description: >-
                    Se deve enviar e-mail ao cliente para cada transação
                    atualizada. Padrão: true.
                  default: true
            examples:
              request:
                summary: Exemplo de requisição em lote
                value:
                  transactions:
                    - hash: abc123...
                      tracking_code: BR123456789BR
                      carrier: correios
                    - hash: def456...
                      tracking_code: TRK987654321
                      carrier: other
                      tracking_url: https://tracking.example.com/TRK987654321
                  send_email: true
        required: true
      responses:
        '200':
          description: Resultado do processamento em lote
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  saved:
                    type: integer
                  failed:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        hash:
                          type: string
                        success:
                          type: boolean
                        message:
                          type: string
                        error:
                          type: string
                          enum:
                            - TRANSACTION_NOT_FOUND
                            - PRODUCT_NOT_FOUND
                            - NOT_PHYSICAL_PRODUCT
                            - SAVE_ERROR
                            - EXCEPTION
              examples:
                success:
                  summary: Resultado com sucesso e falhas
                  value:
                    success: true
                    message: 2 códigos de rastreio salvos, 1 falharam
                    saved: 2
                    failed: 1
                    results:
                      - hash: abc123...
                        success: true
                        message: Código salvo e email enviado
                      - hash: def456...
                        success: true
                        message: Código salvo e email enviado
                      - hash: ghi789...
                        success: false
                        message: Transação não encontrada ou não pertence ao seller
                        error: TRANSACTION_NOT_FOUND
        '401':
          description: Falha na autenticação
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Use o token da Pepper API no formato: `Bearer {seu_token_aqui}`'

````