A API tem como objetivo receber o retorno do processamento dos dados integrados para do Protheus através do Painel de Integração, de forma assíncrona, alterando os status dos itens para processado, erro ou pendente.
A API funciona recebendo a resposta do Protheus e gravando em uma pasta o arquivo XML, em seguida é lido o arquivo pegando os status e alterado os itens no banco com a descrição recebida.
Exemplo:
Parte do arquivo de retorno de um processamento de nota fiscal onde consta erro no processamento por conta dos itens estarem bloqueado no sistema do Protheus.
</ProcessedOn><Status>error</Status><ListOfMessages><Message type="error" code="">Nao foi possivel incluir a nota:
Cliente nao localizado no cadastro: (/01)
Produto bloqueado: (970726)
Produto bloqueado: (900160)
Produto bloqueado: (919199)
Produto nao localizado no cadastro: (900134)
Produto bloqueado: (970726)
Produto bloqueado: (900160)
</Message></ListOfMessages></ProcessingInformation><ReturnContent></ReturnContent></ResponseMessage></TOTVSMessage>