Fluxo de captura do pedido de compra nos documentos fiscais

O fluxo demonstrado a seguir trata o recebimento de NF-e dentro da integração com a InvoiSys.

Endpoints Essenciais 💡

• Criar Pedido de Compra

• Editar Pedido de Compra

• Consultar Pedido de Compra

• Atualizar dados do Pedido de Compra vinculado

Etapas e seus endpoints

Para detalharmos melhor a operação, separamos em tópicos:

1) Consultas periódicas dos documentos fiscais

Após o cadastro da empresa no Portal invoiSys e a configuração do certificado digital, ela estará apta a consultar e receber documentos fiscais diretamente em nossa plataforma, incluindo NF-e, CT-e, NFS-e e Faturas.

Ao receber documentos fiscais via webservice, e-mail ou importação de arquivos XML, a invoiSys verifica os delimitadores personalizados definidos para captura dos pedidos de compra da empresa.

Nos tópicos seguintes, explicaremos o funcionamento da captura por delimitadores customizados e, opcionalmente, por meio da tag oficial xPed na NF-e, para identificar os pedidos de compra de forma eficiente e precisa.

2) Captura por delimitadores customizados

A invoiSys permite a criação flexível de delimitadores personalizados para capturar pedidos de compra dos vários fornecedores de uma empresa. Reconhecemos a dificuldade de padronizar um único delimitador com fornecedores e seus sistemas distintos; por isso, aceitamos as variações necessárias para adaptar-se à operação do contratante.

Com os delimitadores configurados, o sistema consulta as tags de texto dos documentos fiscais para identificar o pedido de compra inserido pelo fornecedor. As tags analisadas são:

• NF-e - infCpl: Tag de informações complementares, que permite texto livre.

• CT-e - xObs: Tag de observações, também usada para texto livre.

• NFS-e - discriminacao: A análise é feita tanto via webservice quanto por OCR, considerando as variações entre municípios.

• Fatura - Pedido de Compra: No layout de e-mail aceito, o campo "Pedido de Compra" é explícito. Quando o fornecedor envia outros dados ou delimitadores, o sistema abstrai as informações necessárias.

Por exemplo, ao configurar um delimitador como "PEDIDOZ", caso o fornecedor envie o pedido com essa referência na tag infCpl da NF-e, a invoiSys identificará e exibirá o número capturado diretamente no Portal.

XML da NF-e com um pedido de compra informado

invoiSys capturá o pedido por meio de um delimitador e disponibiliza a informação

Após a captura, o sistema buscará automaticamente o Pedido de Compra correspondente na base da invoiSys, caso já tenha enviado o pedido previamente via integração. A explicação detalhada sobre a consulta e vinculação será abordada no Tópico 4.

3) Captura pela tag xPed da NF-e

Simplificadamente, e seguindo o layout padrão da SEFAZ, a invoiSys pode capturar o pedido de compra na NF-e por meio da tag oficial xPed. O conceito é o mesmo descrito anteriormente: caso o pedido seja enviado diretamente nessa tag, ele será capturado e disponibilizado na nossa base.

Grupo compra, com o pedido de compra informado na tag xPed

Na NF-e, é possível configurar uma hierarquia de captura para o pedido de compra, especificando se o sistema deve primeiro buscar o pedido na tag xPed ou diretamente pelo delimitador configurado em infCpl, ou vice-versa.

4) Consultando o Pedido de Compra vinculado ao documento fiscal

Após a captura do pedido de compra no documento fiscal, ele é inserido em uma fila para que o sistema busque o Pedido de Compra correspondente enviado à base da invoiSys via integração. Esse processo ocorre continuamente, independentemente de o Pedido de Compra ser enviado após a recepção do documento fiscal na base da invoiSys. Dessa forma, asseguramos a vinculação correta entre o pedido de compra e o(s) documento(s) fiscal(is) associado(s).

Portanto, caso opte por utilizar a integração para ter o controle integral, após a criação do Pedido de Compra, basta consultá-lo regularmente para identificar se houve vinculação, como no caso abaixo:

Consulta do Pedido de Compra

{
  "docData": {
    "numPedidoCompra": "HI32054",
    "dataEmissao": "2024-06-07T14:21:45.034Z",
    "dataVencimento": "0001-01-01T00:00:00Z",
    "codCondPag": "",
    "descrCondPag": "",
    "centroCusto": "",
    "obs": "",
    "valorTotal": 4070.08,
    "fornecedor": {
      "cnpj": "17921427000125",
      "inscricaoEstadual": "",
      "inscricaoMunicipal": "",
      "razaoSocial": "TRANSPORTADORA TESTE",
      "nomeFantasia": "",
      "logradouro": "AVENIDA DEZ",
      "complLogradouro": null,
      "bairro": "",
      "cidade": "FRONTEIRA",
      "uf": "MG",
      "cep": "38230000",
      "pais": null,
      "responsavel": {
        "nome": "",
        "telefone": "",
        "email": "",
        "contato": null
      }
    },
    "contratante": {
      "cnpj": "17921427000125",
      "inscricaoEstadual": "",
      "inscricaoMunicipal": "",
      "razaoSocial": "CONTRATANTE TESTE",
      "nomeFantasia": "",
      "logradouro": "CONTRATANTE TESTE",
      "complLogradouro": null,
      "bairro": "",
      "cidade": "RESENDE",
      "uf": "RJ",
      "cep": "27534010",
      "pais": null,
      "responsavel": {
        "nome": "",
        "telefone": "",
        "email": "",
        "contato": null
      }
    }
  },
  "docStatus": {
    "status": "VD",
    "statusVinculoItem": null
  },
  "docControl": {
    "origem": "",
    "canal": "",
    "documentosVinculados": [
      {
        "obsPag": null,
        "tipoDocOrigem": "nfe",
        "idDocOrigem": "1111111111111",
        "valor": 3226,
        "numero": "421690",
        "statusVinculoItem": null,
        "dataVinculo": "2024-06-12T18:22:31.132Z",
        "dataEmissao": "2024-05-24T17:42:44Z",
        "validacoes": {
          "CnpjEmitente": "0",
          "CnpjDestinatario": "1",
          "Saldo": "0"
        },
        "statusVinculo": "Dados Divergentes",
        "statusCompra": null,
        "dataProcessamento": "0001-01-01T00:00:00Z",
        "dataPagamentoPrevisto": "0001-01-01T00:00:00Z",
        "dataPagamentoRealizado": "0001-01-01T00:00:00Z"
      },
      {
        "obsPag": null,
        "tipoDocOrigem": "nfse",
        "idDocOrigem": "22222222222222222",
        "valor": 1370,
        "numero": "13068",
        "statusVinculoItem": null,
        "dataVinculo": "2024-06-12T18:26:29.951Z",
        "dataEmissao": "2024-01-30T20:30:24Z",
        "validacoes": {
          "CnpjEmitente": "1",
          "CnpjDestinatario": "0",
          "Saldo": "0"
        },
        "statusVinculo": "Dados Divergentes",
        "statusCompra": null,
        "dataProcessamento": "0001-01-01T00:00:00Z",
        "dataPagamentoPrevisto": "0001-01-01T00:00:00Z",
        "dataPagamentoRealizado": "0001-01-01T00:00:00Z"
      }
    ],
    "items": [
      {
        "nItem": "1.000",
        "descricao": "FRETE 12% ICMS",
        "codigo": "61578",
        "gtin": 0,
        "quantidade": 4070.08,
        "unidadeMedida": "UN",
        "precoUnitario": 1,
        "desconto": 0,
        "total": 4070.08,
        "observacao": null
      }
    ]
  }
}

Lista de documentos vinculados

"documentosVinculados": [
      {
        "obsPag": null,
        "tipoDocOrigem": "nfe",
        "idDocOrigem": "1111111111111",
        "valor": 3226,
        "numero": "421690",
        "statusVinculoItem": null,
        "dataVinculo": "2024-06-12T18:22:31.132Z",
        "dataEmissao": "2024-05-24T17:42:44Z",
        "validacoes": {
          "CnpjEmitente": "0",
          "CnpjDestinatario": "1",
          "Saldo": "0"
        },
        "statusVinculo": "Dados Divergentes",
        "statusCompra": null,
        "dataProcessamento": "0001-01-01T00:00:00Z",
        "dataPagamentoPrevisto": "0001-01-01T00:00:00Z",
        "dataPagamentoRealizado": "0001-01-01T00:00:00Z"
      },
      {
        "obsPag": null,
        "tipoDocOrigem": "nfse",
        "idDocOrigem": "22222222222222222",
        "valor": 1370,
        "numero": "13068",
        "statusVinculoItem": null,
        "dataVinculo": "2024-06-12T18:26:29.951Z",
        "dataEmissao": "2024-01-30T20:30:24Z",
        "validacoes": {
          "CnpjEmitente": "1",
          "CnpjDestinatario": "0",
          "Saldo": "0"
        },
        "statusVinculo": "Dados Divergentes",
        "statusCompra": null,
        "dataProcessamento": "0001-01-01T00:00:00Z",
        "dataPagamentoPrevisto": "0001-01-01T00:00:00Z",
        "dataPagamentoRealizado": "0001-01-01T00:00:00Z"
      }
    ],