Resposta à fatura do fornecedor

Este guia descreve a aplicação da Resposta de Aplicativo UBL 2.4 em conformidade com os padrões UBL 2.4. Sua função principal é transmitir o status dos envios de documentos de faturamento às autoridades fiscais. Enviado do da autoridade fiscal por meio de fornecedores ao Google, o documento fornece informações essenciais sobre status de envio e pode incluir links para qualquer arquivo binário de fatura gerado pelo a administração fiscal.

O esquema facilita aos fornecedores a geração de relatórios sobre os resultados dos envios de documentos para Google, incluindo:

  • Status de aceitação dos documentos.
  • Problemas ou erros identificados pela autoridade fiscal.
  • Links para arquivos binários relacionados a faturas ou notas de crédito.

Esse protocolo de comunicação estruturado garante uma interação perfeita entre Google, fornecedores e autoridades fiscais, melhorando a eficiência das faturas processamento e conformidade.

Semelhante ao mecanismo de lote usado para solicitações, o agrupamento de respostas consolida vários documentos em um único envio para mais um gerenciamento eficaz. Informações detalhadas sobre esse mecanismo podem ser encontradas na envio de faturas em lote nesta seção.

A estrutura do esquema, visualizada na imagem, ilustra as configurações a organização e os componentes críticos, ressaltando a abordagem ao status relatórios de envios de faturas:

Diagrama ilustrando a estrutura de um esquema de resposta de faturamento eletrônico

1.0 Cabeçalho de resposta do aplicativo

Detalha metadados essenciais, como o ID da solicitação do fornecedor do Google e a data e Hora em que a resposta foi emitida, no fuso horário UTC.

Elemento Descrição Exemplo
cbc:UUID O ID da solicitação do fornecedor do Google fornecido na solicitação da fatura. 123e4567-e89b-12d3-a456-426614174000
cbc:IssueDate Data de emissão da resposta. 2023-06-02
cbc:IssueTime Hora em que a resposta foi emitida, em UTC. 08:20:00-08:00

Exemplo

<ApplicationResponse>
  <cbc:UUID>123e4567-e89b-12d3-a456-426614174000</cbc:UUID>
  <cbc:IssueDate>2023-06-02</cbc:IssueDate>
  <cbc:IssueTime>08:20:00-08:00</cbc:IssueTime>
  <cac:SenderParty>
    <!-- Sender party details -->
  </cac:SenderParty>
  <cac:ReceiverParty>
    <!-- Receiver party details -->
  </cac:ReceiverParty>
  <cac:DocumentResponse>
    <!-- Document Response content -->
  </cac:DocumentResponse>
</ApplicationResponse>

2.0 Informações do remetente e do destinatário

Esta seção fornece informações sobre o remetente e o destinatário dos Resposta à inscrição, um campo obrigatório de acordo com o padrão UBL. Neste contexto, espera-se que o remetente seja o fornecedor que encaminha a resposta do pelo sistema governamental, e o destinatário precisa ser o Google.

Elemento Descrição Exemplo
cac:SenderParty/cac:PartyName/cbc:Name Nome do fornecedor que encaminha a resposta do sistema governamental. Vendor Company
cac:ReceiverParty/cac:PartyName/cbc:Name Nome da entidade que recebe a resposta. Google

Exemplo

<ApplicationResponse>
  ...
  <cac:SenderParty>
    <cac:PartyName>
      <cbc:Name>Vendor Company</cbc:Name>
    </cac:PartyName>
  </cac:SenderParty>

  <cac:ReceiverParty>
    <cac:PartyName>
      <cbc:Name>Google</cbc:Name>
    </cac:PartyName>
  </cac:ReceiverParty>
  ...
</ApplicationResponse>

3.0 Resposta a documentos

Esta seção fornece detalhes sobre a resposta do documento, abrangendo as o status da resposta e quaisquer referências de documentos associadas geradas como resultado do envio bem-sucedido de documentos ao governo.

Elemento Descrição Exemplo
cac:Response Obrigatório. Contém o status da resposta relacionado ao envio da fatura. Consulte a seção 3.1
cac:DocumentReference Opcional. Pode incluir nenhuma ou várias referências a documentos gerados. Consulte a seção 3.2

Exemplo

<ApplicationResponse>
  ...
  <cac:DocumentResponse>
    <cac:Response>
      <!-- Response details -->
    </cac:Response>
    <cac:DocumentReference>
      <!-- Document Reference (if applicable) -->
    </cac:DocumentReference>
    <cac:DocumentReference>
      <!-- Document Reference (if applicable) -->
    </cac:DocumentReference>
  </cac:DocumentResponse>
</ApplicationResponse>

3.1 Resposta

Cada resposta do aplicativo precisa conter um único cac:Response detalhando o o status atual, exclusivamente associado a um envio de documento. Isso garante para que cada resultado do processamento de documentos seja claramente comunicado.

Elemento Descrição Exemplo
cbc:ReferenceID Identificador exclusivo retornado pelo sistema fiscal para a fatura referenciada. BIL-123456
cbc:ReferenceID/@schemeID Sistema ou padrão que fornece o identificador, esclarecendo a origem dele. KSEF
cac:Status/cbc:StatusReasonCode Código que define a resposta ou o motivo do status, com base no valor predefinido: list. NON
cac:Status/cbc:StatusReason Texto descritivo com mais detalhes sobre o código de status. No Issue

Exemplo

<ApplicationResponse>
  ...
  <cac:DocumentResponse>
    <cac:Response>
      <cbc:ReferenceID schemeID="Vendor Company">BIL-123456</cbc:ReferenceID>
      <cac:Status>
        <cbc:StatusReasonCode>NON</cbc:StatusReasonCode>
        <cbc:StatusReason>No Issue</cbc:StatusReason>
      </cac:Status>
    </cac:Response>
    <cac:DocumentReference>
      <!-- Document Reference (if applicable) -->
    </cac:DocumentReference>
    <cac:DocumentReference>
      <!-- Document Reference (if applicable) -->
    </cac:DocumentReference>
  </cac:DocumentResponse>
</ApplicationResponse>

3.2 Referência do documento

Esta seção é usada para anexar referências a documentos gerados como resultado de o processo de envio de faturas. É opcional e pode conter várias referências , dependendo do número de documentos gerados pela autoridade fiscal.

Elemento Descrição Exemplo
cbc:ID Número da fatura local BIL-123456
cbc:ID/@schemeID Identificador do emissor da referência da fatura Vendor Company
cbc:IssueDate Data em que esta resposta foi emitida pelas autoridades fiscais 2023-06-02
cbc:DocumentTypeCode Tipo de documento que está sendo referenciado, expresso como código (se a fatura for aceita) 380
cbc:DocumentType Tipo de documento que está sendo referenciado, expresso como texto Invoice
cac:Attachment/cac:ExternalReference/cbc:FormatCode Formato da fatura gerada (XML, PDF, URL) XML
cac:Attachment/cac:ExternalReference/cbc:FileName Nome do arquivo gerado no servidor SFTP (para códigos de formato XML e PDF) invoice_GCEMEAD0000000001.pdf
cac:Attachment/cac:ExternalReference/cbc:URI URL para recuperar o arquivo gerado (para o código de formato do URL) https://example.com/invoice/view

Estes exemplos ilustram como os documentos podem ser referenciados na documentação Resposta. O primeiro exemplo envolve documentos transferidos usando SFTP, mostrado em PDF e XML, e o segundo exemplo demonstra um documento acessível usando URL, o que simplifica o acesso direto sem a necessidade de transferência de arquivos protocolos.

Exemplo 1: PDF e Anexos de fatura em XML transferidos usando SFTP

<ApplicationResponse>
  <!-- Sender and Receiver Details -->
  <cac:DocumentResponse>
    <cac:Response>
      <!-- Response Details -->
    </cac:Response>
    <cac:DocumentReference>
      <cbc:ID schemeID="Vendor Company">BIL-123456</cbc:ID>
      <cbc:IssueDate>2023-06-02</cbc:IssueDate>
      <cbc:DocumentTypeCode>380</cbc:DocumentTypeCode>
      <cbc:DocumentType>Invoice</cbc:DocumentType>
      <cac:Attachment>
        <cac:ExternalReference>
          <!-- PDF Document stored on SFTP -->
          <cbc:FormatCode>PDF</cbc:FormatCode>
          <cbc:FileName>invoice_GCEMEAD0000000001.pdf</cbc:FileName>
        </cac:ExternalReference>
      </cac:Attachment>
      <cac:Attachment>
        <cac:ExternalReference>
          <!-- XML Document stored on SFTP -->
          <cbc:FormatCode>XML</cbc:FormatCode>
          <cbc:FileName>invoice_GCEMEAD0000000001.xml</cbc:FileName>
        </cac:ExternalReference>
      </cac:Attachment>
    </cac:DocumentReference>
  </cac:DocumentResponse>
</ApplicationResponse>

Exemplo 2: documento acessível por URL

<ApplicationResponse>
  <!-- Sender and Receiver Details -->
  <cac:DocumentResponse>
    <cac:Response>
      <!-- Response Details -->
    </cac:Response>
    <cac:DocumentReference>
      <cbc:ID schemeID="Vendor Company">BIL-123456</cbc:ID>
      <cbc:IssueDate>2023-06-02</cbc:IssueDate>
      <cbc:DocumentTypeCode>380</cbc:DocumentTypeCode>
      <cbc:DocumentType>Invoice</cbc:DocumentType>
      <cac:Attachment>
        <cac:ExternalReference>
          <!-- Document accessible using URL -->
          <cbc:FormatCode>URL</cbc:FormatCode>
          <cbc:URI>https://example.com/invoice/view</cbc:URI>
        </cac:ExternalReference>
      </cac:Attachment>
    </cac:DocumentReference>
  </cac:DocumentResponse>
</ApplicationResponse>