AP Invoice API

Este guia do desenvolvedor descreve como definir campos de fatura personalizados que não são fornecidos por padrão com o. Fatura de AP API para Processamento de faturas para contas a pagar. Também são fornecidas instruções para definir a autenticação ao usar cXML como carga.

Você pode definir campos de fatura personalizados para o corpo da solicitação. Use o fluxo a seguir para adicionar campos personalizados, mapeá-los para tabelas de destino e formatá-los para disponibilidade na carga:

1. Adicione campos personalizados para importação de fatura
2. Mapeie campos personalizados entre as tabelas de origem e de destino
3. Mapeie campos personalizados para um formato de origem de carga

Defina credenciais para cargas cXML na tabela Credencial do sistema de origem [sn_spend_intg_source_system_credential]. Para obter instruções, consulte Definindo credenciais para autenticação na carga cXML.

Você pode aplicar uma condição de filtro para linhas de fatura que contenham vários ERPs. Para obter informações, consulte Integration errors.

Consulte também:

• Accounts Payable Invoice Processing
• AP Invoice API

Adicione campos personalizados para importação de fatura

Use o procedimento a seguir para adicionar campos personalizados para faturas, linhas de fatura e linhas de imposto de fatura a serem usados com o. Fatura de AP API.

Antes de Iniciar

• Função necessária: administrador
• Escopo da aplicação: Source-to-Pay Integrations

Procedimento

1. Navegar até Tudo > Definição do Sistema > Tabelas.
2. Selecione uma das seguintes tabelas de importação de fatura:
   • Importação de fatura [sn_sp_intg_imp_invoice]
   • Importação de linha de fatura [sn_spend_intg_imp_invoice_line]
   • Importação de linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line]
3. Em Colunas da tabela selecione Novo .
4. Selecione um tipo associado ao valor do campo (por exemplo, Número inteiro ) do Tipo menu.
   Nota:

   Para obter uma lista de tipos válidos, consulte Field types reference.
5. Insira um nome significativo em Rótulo da coluna campo.
   O texto que inclui o rótulo é preenchido automaticamente no Nome da coluna campo.
6. Selecione Salvar ou Enviar .
7. Adicione uma coluna com o mesmo nome e tipo à tabela de fatura [sn_shop_invoice].
   Nota:

   Para obter mais informações sobre colunas e campos, consulte Exploring field administration.
8. Mapeie os campos entre as tabelas de origem e de destino .

Mapeie campos personalizados entre as tabelas de origem e de destino

Use o procedimento a seguir para mapear campos personalizados entre as tabelas de origem e de destino para a API de fatura de AP.

Antes de Iniciar

• Função necessária: administrador
• Escopo da aplicação: Source-to-Pay Integrations

Crie colunas da tabela para mapear o novo campo da tabela de origem para a tabela de destino. Use as etapas em Adicione campos personalizados para importação de fatura.

Procedimento

1. Navegar até Tudo > Conjuntos para importação do sistema > Mapas de transformação.
2. Abra o Mapa de transformação da tabela de importação de fatura.
3. Clique em Novo em Mapas de campo .
4. Selecione o nome do campo personalizado em Campo de origem menu.
5. Selecione o nome do campo personalizado em Campo de destino menu.
6. Selecione Salvar ou Enviar .
7. Mapeie campos personalizados para um formato de origem de carga.

Mapeie campos personalizados para um formato de origem de carga

Use o procedimento a seguir para mapear campos personalizados para uma entrada de carga em JSON, cXML ou XML para a API de fatura de AP.

Antes de Iniciar

• Função necessária: administrador
• Escopo da aplicação: Source-to-Pay Integrations
• Adicione campos personalizados para importação de fatura
• Mapeie campos personalizados entre as tabelas de origem e de destino

Procedimento

1. Navegar até Tudo > Integrações de compras > Fornecedores > Mapeamentos de campos da integração da fatura.
2. Selecione Novo.
3. Adicione o nome do sistema de origem ao Sistema de origem campo.
   • Se este mapeamento de campo se aplicar a todos os sistemas de origem, insira Padrão .
   • Se o mapeamento for específico de um sistema de origem específico, esse valor deve corresponder ao valor do parâmetro de cabeçalho Sistema de origem recebido na API.
     Nota:

     Todos os mapeamentos de campo restantes devem ser configurados especificamente para este sistema de origem.
4. Selecione o formato do sistema de origem para o qual o mapeamento está sendo criado a partir de Formato de origem Lista de seleção (cXML ou json).
5. Forneça um nome (propriedade JSON) ou caminho (atributo ou elemento cXML/xml) para a entrada de carga no Campo de origem campo.
   Você pode exibir a tabela Mapeamento do campo de integração de fatura [sn_spend_intg_invoice_intg_field_mapping] para obter exemplos de configurações de caminho XML e cXML.
6. Adicione o nome de um atributo se o campo for definido como um atributo de elemento para cargas cXML, caso contrário, deixe o campo vazio.
7. Selecione o nome da tabela de destino que contém seu campo personalizado no Tabela relacionada lista.
8. Selecione o nome do campo personalizado em Campo de destino lista.
9. Selecione Salvar ou Enviar .
   O campo mapeado é adicionado à tabela Mapeamento do campo de integração de fatura [sn_spend_intg_invoice_intg_field_mapping].

Definindo credenciais para autenticação na carga cXML

. sn_spend_intg/ap_invoice/cxml O endpoint é autenticado na carga usando credenciais armazenadas na tabela Credencial do sistema de origem [sn_sp_intg_source_system_credential].

Antes de Iniciar

Função necessária: administrador

Identifique o sistema de origem da carga listado na tabela Mapeamentos de campo de integração de fatura [sn_sp_intg_invoice_intg_field_mapping].

Consulte também Fatura de AP – PUBLICAR sn_sn_spend_intg/ap_invoice/cxml.

Procedimento

1. Navegar até Tudo > Integrações de compras > Credenciais do sistema de origem.
2. Selecione Novo.
3. Adicione o nome do sistema de origem listado na tabela Mapeamentos de campo de integração de fatura [sn_spend_intg_invoice_intg_field_mapping] no Sistema de origem campo.
   O nome do sistema de origem deve corresponder ao parâmetro de cabeçalho Sistema de origem.
4. Adicione o nome de usuário a ser buscado em Nome de usuário campo.
   Use este valor no /CXML/Header/To/Credencial elemento.
5. Adicione uma combinação forte de letras, números e caracteres especiais ao Senha campo.
   Use este valor no /CXML/Header/Sender/Credencial elemento.
6. Selecione Enviar.