Ir para o conteúdo principal

ProtheusCupomFiscalEcommerce (STATUS: AJUSTADO)

Documentaçã 
Documentação cnica
Nome do cliente OSKLEN
Nome do projeto IntegraçãIntegração LINX Protheus
Biblioteca wosk_protheus_cupom_fiscal_ecommerce
Data 27/02/2026


HistóHistórico de VersõVersões
Data VersãVersão Modificado por DescriçãDescrição da MudançMudança
27/02/2026 1.0 Maykon/Gustavo CriaçãCriação da documentaçãdocumentação cnica do processo ProtheusCupomFiscalEcommerce.

DescriçãDescrição

Este serviçserviço organiza o envio de cupons fiscais do e-commerce do LINX para o Protheus, garantindo captura consistente, preparaçãpreparação dos dados e registro do resultado da integraçãintegração.

Capturador

DescriçãDescrição Conceitual

Permite a captura manual (por chave composta) e a captura automáautomática (por agendador de tarefas) das transferêtransferências pendentes de integraçãintegração, consultando a origem e registrando os itens para processamento assíassíncrono.

A captura automáautomática segue processamento cronolócronológico a partir do campo DATA_PARA_TRANSFERENCIA, para priorizar registros mais antigos e manter continuidade por posiçãposição; link conceitual: Conceito CronolóCronológico.

Fonte

Origem consultada: view WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ECOMMERCE.
Origem consultada (itens do cupom): view WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ITEM_ECOMMERCE.
Consulta base (utilizada como origem para composiçãcomposição dinâdinâmica de filtros):

SELECT
    TEMP_FILIAL,
    TEMP_NF_SAIDA,
    TEMP_SERIE_NF,
    F2_FILIAL,
    F2_DOC,
    F2_SERIE,
    F2_CLIENTE,
    F2_LOJA,
    F2_TIPOCLI,
    F2_EST,
    F2_DUPL,
    F2_EMISSAO,
    F2_DTDIGIT,
    F2_ESPECIE,
    F2_TIPO,
    F2_COND,
    F2_XNATOPE,
    F2_XCANAL,
    F2_XNATUR,
    F2_TPFRETE,
    F2_VALMERC,
    F2_VALBRUT,
    F2_FRETE,
    F2_SEGURO,
    F2_DESPESA,
    F2_DESCONT,
    F2_VALFAT,
    F2_PREFIXO,
    F2_VALICM,
    F2_BASEICM,
    F2_ICMFRETE,
    F2_VALIPI,
    F2_BASEIPI,
    F2_ICMSRET,
    F2_BRICMS,
    F2_BASIMP6,
    F2_BASIMP5,
    F2_VALIMP6,
    F2_VALIMP5,
    F2_BASFECP,
    F2_BSFCCMP,
    F2_BSFCPST,
    F2_BASEPS3,
    F2_VALPS3,
    F2_BASECF3,
    F2_VALCF3,
    F2_MOEDA,
    F2_NFORI,
    F2_SERIORI,
    F2_UFDEST,
    F2_UFORIG,
    F2_ESPECI1,
    F2_VOLUME1,
    F2_PLIQUI,
    F2_PBRUTO,
    F2_TRANSP,
    F2_SDOC,
    F2_CHVNFE,
    F1_DAUTNFE,
    F1_HAUTNFE,
    F1_PROTOC,
    C5_PARC1,
    C5_PARC2,
    C5_PARC3,
    C5_PARC4,
    C5_PARC5,
    C5_PARC6,
    C5_PARC7,
    C5_PARC8,
    C5_PARC9,
    C5_PARC10,
    C5_PARC11,
    C5_PARC12,
    C5_DATA1,
    C5_DATA2,
    C5_DATA3,
    C5_DATA4,
    C5_DATA5,
    C5_DATA6,
    C5_DATA7,
    C5_DATA8,
    C5_DATA9,
    C5_DATA10,
    C5_DATA11,
    C5_DATA12,
    F3_DTCANC,
    F3_CODRSEF,
    CREPROCESSA,
    F2_XCODREP,
    F2_XCNPJRE,
    F2_XMARCA,
    DATA_PARA_TRANSFERENCIA
FROM
    WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ECOMMERCE (NOLOCK)



Consulta utilizada na captura automáautomática (filtro por data e paginaçãpaginação por posiçãposição):

SELECT
    TEMP_FILIAL,
    TEMP_NF_SAIDA,
    TEMP_SERIE_NF,
    F2_FILIAL,
    F2_DOC,
    F2_SERIE,
    F2_CLIENTE,
    F2_LOJA,
    F2_TIPOCLI,
    F2_EST,
    F2_DUPL,
    F2_EMISSAO,
    F2_DTDIGIT,
    F2_ESPECIE,
    F2_TIPO,
    F2_COND,
    F2_XNATOPE,
    F2_XCANAL,
    F2_XNATUR,
    F2_TPFRETE,
    F2_VALMERC,
    F2_VALBRUT,
    F2_FRETE,
    F2_SEGURO,
    F2_DESPESA,
    F2_DESCONT,
    F2_VALFAT,
    F2_PREFIXO,
    F2_VALICM,
    F2_BASEICM,
    F2_ICMFRETE,
    F2_VALIPI,
    F2_BASEIPI,
    F2_ICMSRET,
    F2_BRICMS,
    F2_BASIMP6,
    F2_BASIMP5,
    F2_VALIMP6,
    F2_VALIMP5,
    F2_BASFECP,
    F2_BSFCCMP,
    F2_BSFCPST,
    F2_BASEPS3,
    F2_VALPS3,
    F2_BASECF3,
    F2_VALCF3,
    F2_MOEDA,
    F2_NFORI,
    F2_SERIORI,
    F2_UFDEST,
    F2_UFORIG,
    F2_ESPECI1,
    F2_VOLUME1,
    F2_PLIQUI,
    F2_PBRUTO,
    F2_TRANSP,
    F2_SDOC,
    F2_CHVNFE,
    F1_DAUTNFE,
    F1_HAUTNFE,
    F1_PROTOC,
    C5_PARC1,
    C5_PARC2,
    C5_PARC3,
    C5_PARC4,
    C5_PARC5,
    C5_PARC6,
    C5_PARC7,
    C5_PARC8,
    C5_PARC9,
    C5_PARC10,
    C5_PARC11,
    C5_PARC12,
    C5_DATA1,
    C5_DATA2,
    C5_DATA3,
    C5_DATA4,
    C5_DATA5,
    C5_DATA6,
    C5_DATA7,
    C5_DATA8,
    C5_DATA9,
    C5_DATA10,
    C5_DATA11,
    C5_DATA12,
    F3_DTCANC,
    F3_CODRSEF,
    CREPROCESSA,
    F2_XCODREP,
    F2_XCNPJRE,
    F2_XMARCA,
    DATA_PARA_TRANSFERENCIA
FROM
    WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ECOMMERCE (NOLOCK)
WHERE
    DATA_PARA_TRANSFERENCIA >= '<DATA_PARA_TRANSFERENCIA>'
ORDER BY
    DATA_PARA_TRANSFERENCIA ASC
OFFSET
    <OFFSET> ROWS FETCH NEXT <LIMITE> ROWS ONLY



Consulta utilizada na captura manual (filtros dinâdinâmicos a partir do identificador informado):

SELECT
    TEMP_FILIAL,
    TEMP_NF_SAIDA,
    TEMP_SERIE_NF,
    F2_FILIAL,
    F2_DOC,
    F2_SERIE,
    F2_CLIENTE,
    F2_LOJA,
    F2_TIPOCLI,
    F2_EST,
    F2_DUPL,
    F2_EMISSAO,
    F2_DTDIGIT,
    F2_ESPECIE,
    F2_TIPO,
    F2_COND,
    F2_XNATOPE,
    F2_XCANAL,
    F2_XNATUR,
    F2_TPFRETE,
    F2_VALMERC,
    F2_VALBRUT,
    F2_FRETE,
    F2_SEGURO,
    F2_DESPESA,
    F2_DESCONT,
    F2_VALFAT,
    F2_PREFIXO,
    F2_VALICM,
    F2_BASEICM,
    F2_ICMFRETE,
    F2_VALIPI,
    F2_BASEIPI,
    F2_ICMSRET,
    F2_BRICMS,
    F2_BASIMP6,
    F2_BASIMP5,
    F2_VALIMP6,
    F2_VALIMP5,
    F2_BASFECP,
    F2_BSFCCMP,
    F2_BSFCPST,
    F2_BASEPS3,
    F2_VALPS3,
    F2_BASECF3,
    F2_VALCF3,
    F2_MOEDA,
    F2_NFORI,
    F2_SERIORI,
    F2_UFDEST,
    F2_UFORIG,
    F2_ESPECI1,
    F2_VOLUME1,
    F2_PLIQUI,
    F2_PBRUTO,
    F2_TRANSP,
    F2_SDOC,
    F2_CHVNFE,
    F1_DAUTNFE,
    F1_HAUTNFE,
    F1_PROTOC,
    C5_PARC1,
    C5_PARC2,
    C5_PARC3,
    C5_PARC4,
    C5_PARC5,
    C5_PARC6,
    C5_PARC7,
    C5_PARC8,
    C5_PARC9,
    C5_PARC10,
    C5_PARC11,
    C5_PARC12,
    C5_DATA1,
    C5_DATA2,
    C5_DATA3,
    C5_DATA4,
    C5_DATA5,
    C5_DATA6,
    C5_DATA7,
    C5_DATA8,
    C5_DATA9,
    C5_DATA10,
    C5_DATA11,
    C5_DATA12,
    F3_DTCANC,
    F3_CODRSEF,
    CREPROCESSA,
    F2_XCODREP,
    F2_XCNPJRE,
    F2_XMARCA,
    DATA_PARA_TRANSFERENCIA
FROM
    WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ECOMMERCE (NOLOCK)
WHERE
    F2_FILIAL = '<F2_FILIAL>'
    AND F2_DOC = '<F2_DOC>'
    AND F2_SERIE = '<F2_SERIE>'
    AND F2_CLIENTE = '<F2_CLIENTE>'
    AND F2_LOJA = '<F2_LOJA>'



Consulta utilizada para compor os itens do cupom:

SELECT
    D2_FILIAL,
    D2_ITEM,
    D2_COD,
    D2_TP,
    D2_UM,
    D2_LOCAL,
    D2_QUANT,
    D2_PRCVEN,
    D2_PRUNIT,
    D2_TOTAL,
    D2_DESC,
    D2_DESCON,
    D2_SEGURO,
    D2_VALFRE,
    D2_DESPESA,
    D2_VALBRUT,
    D2_EMISSAO,
    D2_DTDIGIT,
    D2_DOC,
    D2_SERIE,
    D2_SDOC,
    D2_TIPO,
    D2_ESPECIE,
    D2_CLIENTE,
    D2_LOJA,
    D2_EST,
    D2_CLASFIS,
    D2_TES,
    D2_CF,
    D2_BASEIPI,
    D2_IPI,
    D2_VALIPI,
    D2_BASEICM,
    D2_PICM,
    D2_VALICM,
    D2_BASFECP,
    D2_ALQFECP,
    D2_VALFECP,
    D2_BRICMS,
    D2_ALIQSOL,
    D2_MARGEM,
    D2_ICMSRET,
    D2_BSFCPST,
    D2_ALFCPST,
    D2_VFECPST,
    D2_BASIMP5,
    D2_ALQIMP5,
    D2_VALIMP5,
    D2_BASIMP6,
    D2_ALQIMP6,
    D2_VALIMP6,
    D2_BASEPS3,
    D2_ALIQPS3,
    D2_VALPS3,
    D2_BASECF3,
    D2_ALIQCF3,
    D2_VALCF3,
    D2_DESCZFP,
    D2_DESCZFC,
    D2_BASEDES,
    D2_ALIQCMP,
    D2_PDORI,
    D2_PDDES,
    D2_PDIFAL,
    D2_BSFCCMP,
    D2_ALFCCMP,
    D2_VFCPDIF,
    D2_CC,
    D2_CONTA,
    D2_PESO,
    D2_ESTOQUE,
    D2_NFORI,
    D2_SERIORI,
    D2_ITEMORI,
    D2_XPRMDPR,
    D2_XALIQBA,
    D2_ORIGLAN,
    D2_OP,
    D2_XPDWISE,
    D2_XPDLINX,
    D2_XCOLEC,
    D2_XCOLDE,
    DATA_PARA_TRANSFERENCIA
FROM
    WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ITEM_ECOMMERCE (NOLOCK)
WHERE
    D2_FILIAL = '<D2_FILIAL>'
    AND D2_DOC = '<D2_DOC>'
    AND D2_SERIE = '<D2_SERIE>'
    AND D2_CLIENTE = '<D2_CLIENTE>'
    AND D2_LOJA = '<D2_LOJA>'

OperaçõOperações com Dados

Leitura: consulta as views WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ECOMMERCE  e WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ITEM_ECOMMERCE (itens) para obter o registro atual e compor a lista ITENS do cupom antes de registrar para processamento assíassíncrono.

Captura automáautomática (processamento cronolócronológico): aplica filtro por DATA_PARA_TRANSFERENCIA, ordena por DATA_PARA_TRANSFERENCIA e pagina com OFFSET ... FETCH NEXT ..., garantindo priorizaçãpriorização dos registros mais antigos e continuidade por posiçãposição.

Captura manual: recebe um identificador composto, valida o formato (quantidade de partes) e consulta a origem com filtros exatos (F2_FILIAL, F2_DOC, F2_SERIE, F2_CLIENTE, F2_LOJA) para recuperar o cupom solicitado e seus itens.

PersistêPersistência de posiçãposição/continuidade: registra e atualiza o controle do capturador na tabela wosk_monitor usando evento = 'ProtheusCupomFiscalEcommerce', mantendo posiçãposição, filtro aplicado, datas e situaçãsituação para auditoria e retomada.

Fila de Processamento

DescriçãDescrição Conceitual

A fila recupera um registro pendente e utiliza o conteúconteúdo do registro como base do payload de integraçãintegração. Em seguida, aplica transformaçõtransformações obrigatóobrigatórias de padronizaçãpadronização e realiza a chamada ao Protheus.

O registro de fila éé persistido e atualizado na tabela Fila de Processamento ao longo do processamento, registrando conteúconteúdo, retorno, mensagem, tempo e situaçãsituação final para auditoria e acompanhamento operacional.

EstruturaçãEstruturação de Dados
Campo no payload Origem no registro atual
F2_FILIAL F2_FILIAL
F2_DOC F2_DOC
F2_SERIE F2_SERIE
F2_CLIENTE F2_CLIENTE
F2_LOJA F2_LOJA
F2_TIPOCLI F2_TIPOCLI
F2_EST F2_EST
F2_DUPL F2_DUPL
F2_EMISSAO F2_EMISSAO
F2_DTDIGIT F2_DTDIGIT
F2_ESPECIE F2_ESPECIE
F2_TIPO F2_TIPO
F2_COND F2_COND
F2_XNATOPE F2_XNATOPE
F2_XCANAL F2_XCANAL
F2_XNATUR F2_XNATUR
F2_TPFRETE F2_TPFRETE
F2_VALMERC F2_VALMERC
F2_VALBRUT F2_VALBRUT
F2_FRETE F2_FRETE
F2_SEGURO F2_SEGURO
F2_DESPESA F2_DESPESA
F2_DESCONT F2_DESCONT
F2_VALFAT F2_VALFAT
F2_PREFIXO F2_PREFIXO
F2_VALICM F2_VALICM
F2_BASEICM F2_BASEICM
F2_ICMFRET F2_ICMFRETE
F2_VALIPI F2_VALIPI
F2_BASEIPI F2_BASEIPI
F2_ICMSRET F2_ICMSRET
F2_BRICMS F2_BRICMS
F2_BASIMP5 F2_BASIMP5
F2_BASIMP6 F2_BASIMP6
F2_VALIMP5 F2_VALIMP5
F2_VALIMP6 F2_VALIMP6
F2_BASFECP F2_BASFECP
F2_BSFCCMP F2_BSFCCMP
F2_BSFCPST F2_BSFCPST
F2_BASEPS3 F2_BASEPS3
F2_VALPS3 F2_VALPS3
F2_BASECF3 F2_BASECF3
F2_VALCF3 F2_VALCF3
F2_MOEDA F2_MOEDA
F2_NFORI F2_NFORI
F2_SERIORI F2_SERIORI
F2_UFDEST F2_UFDEST
F2_UFORIG F2_UFORIG
F2_ESPECI1 F2_ESPECI1
F2_VOLUME1 F2_VOLUME1
F2_PLIQUI F2_PLIQUI
F2_PBRUTO F2_PBRUTO
F2_TRANSP F2_TRANSP
F2_SDOC F2_SDOC
F2_CHVNFE F2_CHVNFE
F2_DAUTNFE F1_DAUTNFE
F2_HAUTNFE F1_HAUTNFE
F2_XVENPRE F2_XVENPRE
F3_PROTOC F1_PROTOC
C5_PARC1 C5_PARC1
C5_PARC2 C5_PARC2
C5_PARC3 C5_PARC3
C5_PARC4 C5_PARC4
C5_PARC5 C5_PARC5
C5_PARC6 C5_PARC6
C5_PARC7 C5_PARC7
C5_PARC8 C5_PARC8
C5_PARC9 C5_PARC9
C5_PARC10 C5_PARC10
C5_PARC11 C5_PARC11
C5_PARC12 C5_PARC12
C5_DATA1 C5_DATA1
C5_DATA2 C5_DATA2
C5_DATA3 C5_DATA3
C5_DATA4 C5_DATA4
C5_DATA5 C5_DATA5
C5_DATA6 C5_DATA6
C5_DATA7 C5_DATA7
C5_DATA8 C5_DATA8
C5_DATA9 C5_DATA9
C5_DATA10 C5_DATA10
C5_DATA11 C5_DATA11
C5_DATA12 C5_DATA12
F3_DTCANC F3_DTCANC
F3_CODRSEF F3_CODRSEF
CREPROCESSA CREPROCESSA
F2_XCODREP F2_XCODREP
F2_XCNPJRE F2_XCNPJRE
F2_XMARCA F2_XMARCA
ITENS Lista de itens obtida na origem de itens, composta como ITENS[].
ITENS[].D2_FILIAL D2_FILIAL
ITENS[].D2_ITEM D2_ITEM
ITENS[].D2_COD D2_COD
ITENS[].D2_TP D2_TP
ITENS[].D2_UM D2_UM
ITENS[].D2_LOCAL D2_LOCAL
ITENS[].D2_QUANT D2_QUANT
ITENS[].D2_PRCVEN D2_PRCVEN
ITENS[].D2_PRUNIT D2_PRUNIT
ITENS[].D2_TOTAL D2_TOTAL
ITENS[].D2_DESC D2_DESC
ITENS[].D2_DESCON D2_DESCON
ITENS[].D2_SEGURO D2_SEGURO
ITENS[].D2_VALFRE D2_VALFRE
ITENS[].D2_DESPESA D2_DESPESA
ITENS[].D2_VALBRUT D2_VALBRUT
ITENS[].D2_EMISSAO D2_EMISSAO
ITENS[].D2_DTDIGIT D2_DTDIGIT
ITENS[].D2_DOC D2_DOC
ITENS[].D2_SERIE D2_SERIE
ITENS[].D2_SDOC D2_SDOC
ITENS[].D2_TIPO D2_TIPO
ITENS[].D2_ESPECIE D2_ESPECIE
ITENS[].D2_CLIENTE D2_CLIENTE
ITENS[].D2_LOJA D2_LOJA
ITENS[].D2_EST D2_EST
ITENS[].D2_CLASFIS D2_CLASFIS
ITENS[].D2_TES D2_TES
ITENS[].D2_CF D2_CF
ITENS[].D2_BASEIPI D2_BASEIPI
ITENS[].D2_IPI D2_IPI
ITENS[].D2_VALIPI D2_VALIPI
ITENS[].D2_BASEICM D2_BASEICM
ITENS[].D2_PICM D2_PICM
ITENS[].D2_VALICM D2_VALICM
ITENS[].D2_BASFECP D2_BASFECP
ITENS[].D2_ALQFECP D2_ALQFECP
ITENS[].D2_VALFECP D2_VALFECP
ITENS[].D2_BRICMS D2_BRICMS
ITENS[].D2_ALIQSOL D2_ALIQSOL
ITENS[].D2_MARGEM D2_MARGEM
ITENS[].D2_ICMSRET D2_ICMSRET
ITENS[].D2_BSFCPST D2_BSFCPST
ITENS[].D2_ALFCPST D2_ALFCPST
ITENS[].D2_VFECPST D2_VFECPST
ITENS[].D2_BASIMP5 D2_BASIMP5
ITENS[].D2_ALQIMP5 D2_ALQIMP5
ITENS[].D2_VALIMP5 D2_VALIMP5
ITENS[].D2_BASIMP6 D2_BASIMP6
ITENS[].D2_ALQIMP6 D2_ALQIMP6
ITENS[].D2_VALIMP6 D2_VALIMP6
ITENS[].D2_BASEPS3 D2_BASEPS3
ITENS[].D2_ALIQPS3 D2_ALIQPS3
ITENS[].D2_VALPS3 D2_VALPS3
ITENS[].D2_BASECF3 D2_BASECF3
ITENS[].D2_ALIQCF3 D2_ALIQCF3
ITENS[].D2_VALCF3 D2_VALCF3
ITENS[].D2_DESCZFP D2_DESCZFP
ITENS[].D2_DESCZFC D2_DESCZFC
ITENS[].D2_BASEDES D2_BASEDES
ITENS[].D2_ALIQCMP D2_ALIQCMP
ITENS[].D2_PDORI D2_PDORI
ITENS[].D2_PDDES D2_PDDES
ITENS[].D2_DIFAL D2_PDIFAL
ITENS[].D2_BSFCCMP D2_BSFCCMP
ITENS[].D2_ALFCCMP D2_ALFCCMP
ITENS[].D2_VFCPDIF D2_VFCPDIF
ITENS[].D2_CCUSTO D2_CC
ITENS[].D2_CONTA D2_CONTA
ITENS[].D2_PESO D2_PESO
ITENS[].D2_ESTOQUE D2_ESTOQUE
ITENS[].D2_NFORI D2_NFORI
ITENS[].D2_SERIORI D2_SERIORI
ITENS[].D2_ITEMORI D2_ITEMORI
ITENS[].D2_XPRMDPR D2_XPRMDPR
ITENS[].D2_XALIQBA D2_XALIQBA
ITENS[].D2_ORIGLAN D2_ORIGLAN
ITENS[].D2_OP D2_OP
ITENS[].D2_XPDWISE D2_XPDWISE
ITENS[].D2_XPDLINX D2_XPDLINX
ITENS[].D2_XCOLEC D2_XCOLEC
ITENS[].D2_XCOLDE D2_XCOLDE

Tratamento de Dados

Antes do envio, os campos numénuméricos do cupom o padronizados por rotina numénumérica, garantindo consistêconsistência de formato para integraçãintegração.

F2_VALMERC, F2_VALBRUT, F2_FRETE, F2_DESPESA, F2_SEGURO, F2_DESCONT, F2_VALFAT, F2_VALICM, F2_BASEICM, F2_ICMFRET, F2_VALIPI, F2_BASEIPI, F2_ICMSRET, F2_BRICMS, F2_BASIMP5, F2_VALIMP5, F2_BASIMP6, F2_VALIMP6, F2_BASFECP, F2_BSFCCMP, F2_BSFCPST, F2_BASEPS3, F2_VALPS3, F2_BASECF3, F2_VALCF3, F2_MOEDA, F2_VOLUME1, F2_PLIQUI, F2_PBRUTO, C5_PARC1, C5_PARC2, C5_PARC3, C5_PARC4, C5_PARC5, C5_PARC6, C5_PARC7, C5_PARC8, C5_PARC9, C5_PARC10, C5_PARC11, C5_PARC12: normalizados com o padrãpadrão da rotina numénumérica.

Nos itens (ITENS[]), os campos numénuméricos tambétambém o padronizados, com atençãatenção especial àà precisãprecisão:

D2_QUANT: normalizado com 3 casas decimais (setNumeric(..., 3, false))
D2_PRCVEN, D2_PRUUNIT: normalizado com 5 casas decimais (setNumeric(..., 5, false))

D2_TOTAL, D2_DESC, D2_DESCON, D2_SEGURO, D2_VALFRE, D2_DESPESA, D2_VALBRUT, D2_BASEIPI, D2_IPI, D2_VALIPI, D2_BASEICM, D2_PICM, D2_VALICM, D2_BASFECP, D2_ALQFECP, D2_VALFECP, D2_BRICMS, D2_ALIQSOL, D2_MARGEM, D2_ICMSRET, D2_BSFCPST, D2_ALFCPST, D2_VFECPST, D2_BASIMP5, D2_ALQIMP5, D2_VALIMP5, D2_BASIMP6, D2_ALQIMP6, D2_VALIMP6, D2_BASEPS3, D2_ALIQPS3, D2_VALPS3, D2_BASECF3, D2_ALIQCF3, D2_VALCF3, D2_DESCZFP, D2_DESCZFC, D2_BASEDES, D2_ALIQCMP, D2_XPRMDPR, D2_XALIQBA, D2_PDORI, D2_PDDES, D2_DIFAL, D2_BSFCCMP, D2_ALFCCMP, D2_VFCPDIF, D2_PESO: normalizados com o padrãpadrão da rotina numénumérica.

IntegraçãIntegração com o Protheus
  • Chamada: RequisiçãRequisição HTTP
  • Recurso: /rest/documento_saida
  • todo HTTPPOST
  • CabeçCabeçalhos:
    • tenantId: <UF_DA_FILIAL>,<F2_FILIAL> (montado a partir dos 2 primeiros caracteres de F2_FILIAL + rgula + o valor completo de F2_FILIAL)

Exemplo de payload enviado (JSON):

{
  "F2_FILIAL": "",
  "F2_DOC": "",
  "F2_SERIE": "",
  "F2_CLIENTE": "",
  "F2_LOJA": "",
  "F2_TIPOCLI": "",
  "F2_EST": "",
  "F2_DUPL": "",
  "F2_EMISSAO": "",
  "F2_DTDIGIT": "",
  "F2_ESPECIE": "",
  "F2_TIPO": "",
  "F2_COND": "",
  "F2_XNATOPE": "",
  "F2_XCANAL": "",
  "F2_XNATUR": "",
  "F2_TPFRETE": "",
  "F2_VALMERC": "",
  "F2_VALBRUT": "",
  "F2_FRETE": "",
  "F2_SEGURO": "",
  "F2_DESPESA": "",
  "F2_DESCONT": "",
  "F2_VALFAT": "",
  "F2_PREFIXO": "",
  "F2_VALICM": "",
  "F2_BASEICM": "",
  "F2_ICMFRET": "",
  "F2_VALIPI": "",
  "F2_BASEIPI": "",
  "F2_ICMSRET": "",
  "F2_BRICMS": "",
  "F2_BASIMP5": "",
  "F2_BASIMP6": "",
  "F2_VALIMP5": "",
  "F2_VALIMP6": "",
  "F2_BASFECP": "",
  "F2_BSFCCMP": "",
  "F2_BSFCPST": "",
  "F2_BASEPS3": "",
  "F2_VALPS3": "",
  "F2_BASECF3": "",
  "F2_VALCF3": "",
  "F2_MOEDA": "",
  "F2_NFORI": "",
  "F2_SERIORI": "",
  "F2_UFDEST": "",
  "F2_UFORIG": "",
  "F2_ESPECI1": "",
  "F2_VOLUME1": "",
  "F2_PLIQUI": "",
  "F2_PBRUTO": "",
  "F2_TRANSP": "",
  "F2_SDOC": "",
  "F2_CHVNFE": "",
  "F2_DAUTNFE": "",
  "F2_HAUTNFE": "",
  "F2_XVENPRE": "",
  "F3_PROTOC": "",
  "C5_PARC1": "",
  "C5_PARC2": "",
  "C5_PARC3": "",
  "C5_PARC4": "",
  "C5_PARC5": "",
  "C5_PARC6": "",
  "C5_PARC7": "",
  "C5_PARC8": "",
  "C5_PARC9": "",
  "C5_PARC10": "",
  "C5_PARC11": "",
  "C5_PARC12": "",
  "C5_DATA1": "",
  "C5_DATA2": "",
  "C5_DATA3": "",
  "C5_DATA4": "",
  "C5_DATA5": "",
  "C5_DATA6": "",
  "C5_DATA7": "",
  "C5_DATA8": "",
  "C5_DATA9": "",
  "C5_DATA10": "",
  "C5_DATA11": "",
  "C5_DATA12": "",
  "F3_DTCANC": "",
  "F3_CODRSEF": "",
  "CREPROCESSA": "",
  "F2_XCODREP": "",
  "F2_XCNPJRE": "",
  "F2_XMARCA": "",
  "ITENS": [
    {
      "D2_FILIAL": "",
      "D2_ITEM": "",
      "D2_COD": "",
      "D2_TP": "",
      "D2_UM": "",
      "D2_LOCAL": "",
      "D2_QUANT": "",
      "D2_PRCVEN": "",
      "D2_PRUNIT": "",
      "D2_TOTAL": "",
      "D2_DESC": "",
      "D2_DESCON": "",
      "D2_SEGURO": "",
      "D2_VALFRE": "",
      "D2_DESPESA": "",
      "D2_VALBRUT": "",
      "D2_EMISSAO": "",
      "D2_DTDIGIT": "",
      "D2_DOC": "",
      "D2_SERIE": "",
      "D2_SDOC": "",
      "D2_TIPO": "",
      "D2_ESPECIE": "",
      "D2_CLIENTE": "",
      "D2_LOJA": "",
      "D2_EST": "",
      "D2_CLASFIS": "",
      "D2_TES": "",
      "D2_CF": "",
      "D2_BASEIPI": "",
      "D2_IPI": "",
      "D2_VALIPI": "",
      "D2_BASEICM": "",
      "D2_PICM": "",
      "D2_VALICM": "",
      "D2_BASFECP": "",
      "D2_ALQFECP": "",
      "D2_VALFECP": "",
      "D2_BRICMS": "",
      "D2_ALIQSOL": "",
      "D2_MARGEM": "",
      "D2_ICMSRET": "",
      "D2_BSFCPST": "",
      "D2_ALFCPST": "",
      "D2_VFECPST": "",
      "D2_BASIMP5": "",
      "D2_ALQIMP5": "",
      "D2_VALIMP5": "",
      "D2_BASIMP6": "",
      "D2_ALQIMP6": "",
      "D2_VALIMP6": "",
      "D2_BASEPS3": "",
      "D2_ALIQPS3": "",
      "D2_VALPS3": "",
      "D2_BASECF3": "",
      "D2_ALIQCF3": "",
      "D2_VALCF3": "",
      "D2_DESCZFP": "",
      "D2_DESCZFC": "",
      "D2_BASEDES": "",
      "D2_ALIQCMP": "",
      "D2_PDORI": "",
      "D2_PDDES": "",
      "D2_DIFAL": "",
      "D2_BSFCCMP": "",
      "D2_ALFCCMP": "",
      "D2_VFCPDIF": "",
      "D2_CCUSTO": "",
      "D2_CONTA": "",
      "D2_PESO": "",
      "D2_ESTOQUE": "",
      "D2_NFORI": "",
      "D2_SERIORI": "",
      "D2_ITEMORI": "",
      "D2_XPRMDPR": "",
      "D2_XALIQBA": "",
      "D2_ORIGLAN": "",
      "D2_OP": "",
      "D2_XPDWISE": "",
      "D2_XPDLINX": "",
      "D2_XCOLEC": "",
      "D2_XCOLDE": ""
    }
  ]
}


Tratamento de retorno

AusêAusência de resposta: retorna erro JSON: O HOUVE RESPOSTA.

Resposta inváinválida/inesperada: retorna erro JSON: O FOI POSSÍPOSSÍVEL DECODIFICAR A RESPOSTA.

Erro identificado: considera falha quando existir code no retorno ou quando Mensagem for ERRO.

Sucesso: considera sucesso quando o sinalizaçãsinalização de erro e Mensagem o éé ERRO.

Aguardo de callback: em sucesso, se o retorno contiver ZB_FILIAL e ZB_ID, e ZB_DATRET estiver vazio, registra controle de callback e define mensagem Aguardando Processamento no Protheus.

ReclassificaçãReclassificação de erro para sucesso: quando a mensagem detalhada contécontém indicaçãindicação de “já“já cadastrado”cadastrado”, o processamento éé tratado como sucesso (ajuste de status e limpeza do indicador code, quando presente)

 
Encaminhamento em cenácenário de erro

Quando ocorre erro na integraçãintegração (ausêausência de resposta, resposta inváinválida ou retorno com indicador de falha), o registro éé finalizado como erro e permanece registrado em Fila de Processamento com detalhes de mensagem e retorno, permitindo acompanhamento e reprocessamento conforme necessidade operacional.
Quando a falha estiver relacionada àà dependêdependência de integraçãintegração do cliente, o registro pode ser marcado como suspenso atéaté que a condiçãcondição seja atendida, evitando envio incompleto ao Protheus.

 
Rotinas Inteligentes

Cliente Integrado:setProtheusClienteIntegrado: validada antes da integraçãintegração do documento. Garante que o cliente relacionado esteja integrado para evitar envio inconsistente. ApóApós confirmaçãconfirmação de sucesso da integraçãintegração, reinicia os processos que estãestão suspensos marcados com  "ProtheusCliente" vinculados com o registro atual.
link: Cliente Integradohttps://kb.illimitar.pro/books/integracao-linx-protheus/page/setprotheusclienteintegrado

Cupom Ecommerce Integrado:setProtheusCupomEcommerceIntegrado: executada apóapós confirmaçãconfirmação de sucesso. Marca o cupom como integrado e permite regularizar cenácenários de reenvio quando necessánecessário.
link: Cupom Ecommerce Integradohttps://kb.illimitar.pro/books/integracao-linx-protheus/page/setprotheuscupomecommerceintegrado

NotificaçãNotificação
Existe um mecanismo de notificaçãnotificação que identifica os itens com erro na fila de processamento, ordenando por data de processamento e enviando em um relatórelatório a destinatádestinatários prépré-definidos.

Fluxo do Processo

Diagrama sem nome.jpg


CritéCritérios de AceitaçãAceitação
Processo Subprocesso DescriçãDescrição SituaçãSituação esperada
Capturador Captura cronolócronológica e controle de posiçãposição Ao consultar a view WOSK_SERVICO_ENVIA_PROTHEUS_CUPOM_ECOMMERCE com filtro por DATA_PARA_TRANSFERENCIA, ordenaçãordenação e paginaçãpaginação, deve manter continuidade por posiçãposição persistida em wosk_monitor (evento, offset, data_posicao). PosiçãPosição atualizada no controle do capturador e registros pendentes registrados para processamento assíassíncrono.
Capturador Captura manual por identificador composto Ao informar um identificador composto no padrãpadrão F2_FILIAL-F2_DOC-F2_SERIE-F2_CLIENTE-F2_LOJA, deve consultar a origem com filtros exatos desses campos e registrar o registro correspondente para processamento, incluindo a lista ITENS. Registro pendente registrado para processamento, associado ao cupom solicitado e apto a integraçãintegração.
Fila de Processamento IntegraçãIntegração com Protheus Ao processar um registro pendente em fila de processo (serviçserviço ProtheusCupomFiscalEcommerce), deve montar o payload conforme, aplicar padronizaçãpadronização numénumérica (incluindo D2_QUANT com 3 casas e D2_PRCVEN/D2_PRUNIT com 5 casas) e realizar a requisiçãrequisição ao recurso /rest/documento_saida com cabeçcabeçalho tenantId. Registro atualizado em fila de processo com retorno/mensagem e situaçãsituação final coerente (sucesso quando o houver erro; erro quando houver ausêausência de resposta, resposta inváinválida, code ou Mensagem = ERRO).