Convenções de namespace do XML

Nosso sistema emprega um conjunto de namespaces XML projetados para estruturar e identificar exclusivos nas solicitações de fatura, nota de crédito e documentos em lote, Respostas. Este guia lista esses namespaces e seu uso específico em nossos formatos de documentos.

Utilização de namespaces na formatação de documentos

Nossos documentos XML são construídos com adesão a um conjunto definido de namespaces, garantindo consistência e compatibilidade com o padrão UBL 2.4 para faturamentos e notas de crédito. Os namespaces facilitam a distinção entre diferentes segmentos dos documentos, como especificações da fatura, informações detalhes da anotação e componentes comuns. A tabela a seguir lista os namespaces usado:

Prefixo URI do namespace Descrição
inv urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 Usado especificamente para elementos de documentos de fatura.
cn urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2 Aplicado a elementos dentro de documentos de nota de crédito.
cac urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2 Representa componentes agregados comuns em diferentes tipos de documentos.
cbc urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2 Indica os componentes básicos usados universalmente em documentos UBL.

Namespaces em lotes de documentos

Para a agregação de vários documentos em uma única solicitação em lote ou resposta, nosso framework não usa especificamente o namespace ext no no nível do lote. Em vez disso, os namespaces UBL 2.4 padrão são empregados diretamente para asseguram o processamento claro e direto de cada documento do lote.

Exemplo de declaração de namespace em uma solicitação em lote:

<RequestBatch xmlns:inv="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
              xmlns:cn="urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2"
              xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
              xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
              xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2"
              batchID="Batch-001"
              documentCount="500">
    ...
</RequestBatch>