Ответ на счет поставщика

В этом руководстве описывается применение схемы ответа приложения UBL 2.4, соответствующей стандартам UBL 2.4. Его основной функцией является передача статуса подачи платежных документов в налоговые органы. Документ, отправляемый налоговым органом через поставщиков в Google, содержит важную информацию о статусе подачи и может включать ссылки на любые двоичные файлы счетов, созданных налоговой администрацией.

Схема помогает поставщикам сообщать о результатах отправки документов в Google, включая:

  • Статус приема документов.
  • Проблемы или ошибки, выявленные налоговым органом.
  • Ссылки на соответствующие двоичные файлы для счетов-фактур или кредит-нот.

Этот структурированный протокол связи обеспечивает бесперебойное взаимодействие между Google, поставщиками и налоговыми органами, повышая эффективность обработки счетов и соблюдение нормативных требований.

Подобно механизму пакетной обработки, используемому для запросов, подход пакетной обработки ответов объединяет несколько документов в одном представлении для более эффективного управления. Подробную информацию об этом механизме можно найти в разделе пакетной обработки ответов на счета .

Структура схемы, представленная на изображении, иллюстрирует организацию документа и его критические компоненты, подчеркивая подход к отчетности о состоянии отправки счетов:

Схема, иллюстрирующая структуру схемы ответа на выставление электронных счетов

1.0 Заголовок ответа приложения

Содержит важные метаданные, такие как идентификатор запроса поставщика Google, а также дату и время выдачи ответа в формате UTC.

Элемент Описание Пример
cbc:UUID Идентификатор запроса поставщика Google, указанный в запросе счета. 123e4567-e89b-12d3-a456-426614174000
cbc:IssueDate Дата получения ответа. 2023-06-02
cbc:IssueTime Время получения ответа в формате UTC. 08:20:00-08:00

Пример

<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 Информация об отправителе и получателе

В этом разделе представлена ​​информация об отправителе и получателе ответа приложения — обязательное поле согласно стандарту UBL. В этом контексте ожидается, что отправителем будет поставщик, который пересылает ответ от государственной системы, а получателем должен быть Google.

Элемент Описание Пример
cac:SenderParty/cac:PartyName/cbc:Name Имя поставщика, пересылающего ответ от государственной системы. Vendor Company
cac:ReceiverParty/cac:PartyName/cbc:Name Имя объекта, получающего ответ. Google

Пример

<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 Ответ на документ

В этом разделе представлена ​​подробная информация об ответе на документ, включая статус ответа и любые связанные с ним ссылки на документы, созданные в результате успешной подачи документа правительству.

Элемент Описание Пример
cac:Response Обязательный. Содержит статус ответа, связанный с отправкой счета. См. раздел 3.1.
cac:DocumentReference Необязательный. Может включать ноль или множество ссылок на созданные документы. См. раздел 3.2.

Пример

<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 Ответ

Каждый ответ приложения должен содержать один cac:Response с подробным описанием текущего статуса, однозначно связанный с отправкой документа. Это гарантирует четкое представление каждого результата обработки документа.

Элемент Описание Пример
cbc:ReferenceID Уникальный идентификатор, возвращаемый налоговой системой для указанного счета. BIL-123456
cbc:ReferenceID/@schemeID Система или стандарт, предоставляющий идентификатор и уточняющий его источник. KSEF
cac:Status/cbc:StatusReasonCode Код, определяющий причину ответа или состояния на основе предопределенного значения: list . NON
cac:Status/cbc:StatusReason Описательный текст, предоставляющий более подробную информацию о коде состояния. No Issue

Пример

<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 Ссылка на документ

Этот раздел используется для прикрепления ссылок на документы, созданные в результате процесса выставления счета. Он не является обязательным и может содержать несколько ссылок в зависимости от количества документов, формируемых налоговым органом.

Элемент Описание Пример
cbc:ID Местный номер счета-фактуры BIL-123456
cbc:ID/@schemeID Идентификатор эмитента ссылки на счет-фактуру Vendor Company
cbc:IssueDate Дата выдачи настоящего ответа налоговыми органами 2023-06-02
cbc:DocumentTypeCode Тип документа, на который делается ссылка, выраженный в виде кода (если счет-фактура принят) 380
cbc:DocumentType Тип документа, на который ссылаются, выраженный в виде текста Invoice
cac:Attachment/cac:ExternalReference/cbc:FormatCode Формат создаваемого счета (XML, PDF, URL) XML
cac:Attachment/cac:ExternalReference/cbc:FileName Имя сгенерированного файла на SFTP-сервере (для кодов формата XML и PDF) invoice_GCEMEAD0000000001.pdf
cac:Attachment/cac:ExternalReference/cbc:URI URL-адрес для получения сгенерированного файла (для кода формата URL-адреса) https://example.com/invoice/view

Эти примеры иллюстрируют, как на документы могут ссылаться в ответе приложения. В первом примере используются документы, передаваемые по SFTP, в форматах PDF и XML, а второй пример демонстрирует документ, доступный по URL-адресу, что упрощает прямой доступ без необходимости использования протоколов передачи файлов.

Пример 1. Вложения счетов в формате PDF и XML, передаваемые с использованием 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>

Пример 2. Документ доступен по 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>