Arquivos da Caixa Postal

Cada arquivo de uma caixa postal é Recebido (chegou na Caixa de Entrada, enviado por você) ou Enviado (foi para a Caixa de Saída, entregue pela Kobana). O que a Kobana faz com o arquivo depende do tipo da caixa (veja Caixa Postal).

Onde fica no painel

Na tela da caixa postal, as abas Caixa de Entrada e Caixa de Saída mostram os 10 arquivos mais recentes de cada lado, com paginação. O ícone de atualizar, ao lado das abas, recarrega a lista.

A tela Arquivos reúne os arquivos de todas as caixas, com UID, Nome, Tipo, Tamanho e Enviado em. Quando a conta ainda não tem caixas postais, ela aparece no link Arquivos EDI da tela inicial da Caixa Postal.

Lista de arquivos

Cada linha mostra:

• um ícone do canal por onde o arquivo chegou (S3, e-mail, SFTP, WhatsApp ou Syncthing). Ao passar o mouse, aparecem detalhes da origem; num arquivo recebido por e-mail, por exemplo, o assunto, o remetente e a data;
• o nome do arquivo, com um botão que copia o UID e o nome;
• o tamanho;
• o botão de download, quando o conteúdo ainda está disponível;
• o ícone de status.

Status

Status	Ícone	Significado
Pendente	Ícone girando	O arquivo ainda não foi processado.
Processado	Ícone verde	O processamento terminou. Ao passar o mouse, o texto depende do tipo da caixa: "Importação criada com sucesso!", "Processado com sucesso!", "Salvo com sucesso!" ou, na Caixa de Saída, "Enviado para as caixas de saída com sucesso!".
Ignorado	Ícone amarelo	O arquivo não foi processado. O motivo aparece ao passar o mouse, por exemplo "Arquivo vazio (0 bytes)" ou formato inválido.
Erro	Ícone vermelho	O processamento falhou. A mensagem de erro aparece ao passar o mouse.

Regras de processamento da Caixa de Entrada:

• Arquivo vazio (0 bytes) é ignorado.
• Numa caixa de Importação/Exportação, o arquivo precisa ser de texto ou ter uma das extensões .csv, .txt, .rem, .ret, .tab, .tsv, .dsv, .psv ou .dat. Fora disso, é ignorado com a mensagem de formato inválido.
• Numa caixa de Importação/Exportação, se o nome do arquivo não indicar o tipo de importação, o arquivo vai para Erro.
• Numa caixa EDI (CNAB Remessa/CNAB Retorno), cada arquivo vira um retorno em Arquivos de Retorno (veja Retornos).

Tela do arquivo

Mostra Nome, Tipo MIME, Tamanho, a caixa postal (nome e slug), o botão Baixar Arquivo, Processado em, ID Externo, Etiquetas, dados personalizados e as datas (Enviado em, Criado em, Atualizado em). Um selo indica se o arquivo é Recebido ou Enviado.

No menu Ações:

• Download: baixa o arquivo.
• Editar: altera Nome, Tipo, ID Externo, Etiquetas e o conteúdo (tamanho máximo de 100MB).
• Excluir: pede confirmação mostrando nome, tipo e tamanho, e apaga o arquivo.

Por quanto tempo o conteúdo fica disponível

O conteúdo de arquivos Processado, Ignorado ou com Erro é apagado 7 dias depois da última atualização do arquivo. O registro continua na lista, sem o botão de download.

Permissões

Módulo Caixa Postal, produto Arquivos:

Ação no painel	Ação da permissão
Ver e baixar arquivos	Ações Básicas
Editar	Alterar
Excluir	Excluir

Eventos de webhook

Código	Quando
mailbox.entry.file.received	Um arquivo chegou na Caixa de Entrada.
mailbox.entry.file.sent	Um arquivo foi para a Caixa de Saída.
mailbox.file.db.created, mailbox.file.db.updated, mailbox.file.db.deleted	O registro do arquivo foi criado, alterado ou excluído.

Pela API

Os arquivos podem ser enviados, listados, consultados e excluídos pela API v2.