Partilhar via

SureXeroLite (Editora Independente) (Pré-visualização)

Desbloqueie o poder de um conector versátil concebido para uma configuração sem esforço e integração perfeita nas suas aplicações empresariais preferidas. Com esse conector, você pode gerar faturas sem esforço, gerenciar clientes e produtos e acessar facilmente os detalhes da fatura, criando um fluxo de trabalho suave e eficiente.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte 848
URL https://service.nowplatform.co/csm
Email support@848.co
Metadados do conector
Editora O Grupo 848
Sítio Web https://www.xero.com
Política de privacidade https://www.xero.com/uk/legal/privacy
Categorias Produtividade; Finanças

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Adicionar um novo contacto

Esta ação permite que você adicione um novo contato no Xero
Adicionar uma nova fatura

Esta ação permite que você adicione uma nova fatura no Xero
Iniciar sessão no Xero

Inicie sessão na sua conta Xero para começar
Listar contatos

Esta ação permite que você liste os contatos do Xero que correspondem às opções selecionadas
Listar faturas

Esta ação permite listar as faturas do Xero que correspondem às opções selecionadas

Adicionar um novo contacto

ID da Operação:
PostContacts

Esta ação permite que você adicione um novo contato no Xero

Parâmetros

Name Chave Necessário Tipo Description
ID do locatário Xero
 xero-tenant-id True string

ID do locatário Xero
Nome
 Name True string

Nome completo do contacto/organização
Nome Próprio
 FirstName string

Nome do contato principal
Apelido
 LastName string

Apelido do contacto principal
Endereço de E-mail
 EmailAddress string

Endereço de e-mail de contato principal
Tipo de Imposto de Contas a Receber
 AccountsReceivableTaxType string

Tipo de imposto padrão usado para contato em faturas de RA

Devoluções

Name Caminho Tipo Description
Contacts
 Contacts array of object

Contacts
ID de contato
 Contacts.ContactID string

Identificador Xero
Número de Contacto
 Contacts.ContactNumber string

Número para identificar contatos em sistemas externos
Status do contato
 Contacts.ContactStatus string

Estado atual de um contacto
Nome
 Contacts.Name string

Nome completo do contacto/organização
Nome Próprio
 Contacts.FirstName string

Nome do contato principal
Apelido
 Contacts.LastName string

Apelido do contacto principal
Endereço de E-mail
 Contacts.EmailAddress string

Endereço de e-mail de contato principal
Dados da conta bancária
 Contacts.BankAccountDetails string

Número de conta bancária do contacto
Addresses
 Contacts.Addresses array of object

Endereços para um contacto
EndereçoType
 Contacts.Addresses.AddressType string

Tipo de endereço
City
 Contacts.Addresses.City string

City
Região
 Contacts.Addresses.Region string

Região
Código Postal
 Contacts.Addresses.PostalCode string

Código Postal
Country
 Contacts.Addresses.Country string

Country
Telefones
 Contacts.Phones array of object

Telefones para um contato
Tipo de Telefone
 Contacts.Phones.PhoneType string

Tipo de telefone
Número de telefone
 Contacts.Phones.PhoneNumber string

Número de Telefone
PhoneAreaCode
 Contacts.Phones.PhoneAreaCode string

Código de Área do Telefone
TelefoneCountryCode
 Contacts.Phones.PhoneCountryCode string

Telefone Código do país
Contacts.UpdatedDateUTC string

Data de atualização UTC
Pessoas de Contacto
 Contacts.ContactPersons array of object

Pessoas de contato adicionais
Nome Próprio
 Contacts.ContactPersons.FirstName string

Nome da pessoa de contacto adicional
Apelido
 Contacts.ContactPersons.LastName string

Apelido da pessoa de contacto adicional
Endereço de E-mail
 Contacts.ContactPersons.EmailAddress string

Endereço de e-mail da pessoa de contato adicional

Adicionar uma nova fatura

ID da Operação:
PostInvoice

Esta ação permite que você adicione uma nova fatura no Xero

Parâmetros

Name Chave Necessário Tipo Description
ID do locatário Xero
 xero-tenant-id True string

ID do locatário Xero
Date
 Date string

Data de emissão da fatura – AAAA-MM-DD
Data Para Conclusão
 DueDate string

Data de vencimento da fatura – AAAA-MM-DD
Tipo de fatura
 Type True string

Tipo de fatura (ACCREC - uma fatura de venda ou fatura de cliente, ACCPAY-uma fatura ou fatura de fornecedor)
Número de referência adicional
 Reference string

Apenas ACCREC – número de referência adicional
ID de contato
 ContactID True string

Identificador Xero (único dentro das organizações)
Tipos de quantidade de linha
 LineAmountTypes string

Os valores de linha são exclusivos de impostos por padrão se você não especificar esse elemento. (Exclusivo, Inclusive, NoTax).
Número da Fatura
 InvoiceNumber string

Código alfanumérico único que identifica a fatura
Descrição do item de linha
 Description True string

Descrição do item de linha
Quantidade de item de linha
 Quantity True number

Quantidade de item de linha
Valor da Unidade de Item de Linha
 UnitAmount True number

Valor da Unidade de Item de Linha
Código de Conta de Item de Linha
 AccountCode string

Código de conta alfanumérico definido pelo cliente, por exemplo, 200 ou VENDAS
Taxa de desconto
 DiscountRate number

Desconto percentual ou valor de desconto que está sendo aplicado a um item de linha.
Código de Moeda
 CurrencyCode string

A moeda em que a fatura foi levantada
Taxa de câmbio
 CurrencyRate number

A taxa de câmbio de uma fatura multimoeda
Estado da fatura
 Status string

Estado da fatura (RASCUNHO, SUBMETIDO, AUTORIZADO)
Data de Pagamento Prevista
 ExpectedPaymentDate string

Mostrado em faturas de vendas (Contas a Receber) quando isso tiver sido definido

Devoluções

Name Caminho Tipo Description
Invoices
 Invoices array of object

Invoices
ID de contato
 Invoices.Contact.ContactID string

Identificador de contato Xero
Nome
 Invoices.Contact.Name string

Nome completo do contacto/organização
Date
 Invoices.Date string

Data de emissão da fatura – AAAA-MM-DD
Data Para Conclusão
 Invoices.DueDate string

Data de vencimento da fatura – AAAA-MM-DD
Estado da fatura
 Invoices.Status string

Estado da fatura (RASCUNHO, SUBMETIDO, AUTORIZADO)
Tipos de quantidade de linha
 Invoices.LineAmountTypes string

Tipos de valor de linha (exclusivo, inclusive, sem imposto)
Itens de linha
 Invoices.LineItems array of object

Itens de linha
Description
 Invoices.LineItems.Description string

Descrição do item de linha
Montante unitário
 Invoices.LineItems.UnitAmount number

Valor unitário do item de linha
Tipo de Imposto
 Invoices.LineItems.TaxType string

Usado como uma substituição se o Código de Imposto padrão para o AccountCode selecionado não estiver correto
Valor do Imposto
 Invoices.LineItems.TaxAmount number

O valor do imposto é calculado automaticamente como uma porcentagem do valor da linha (veja abaixo) com base na taxa de imposto.
Montante de Linha
 Invoices.LineItems.LineAmount number

O valor da linha reflete o preço descontado se uma DiscountRate tiver sido usada
Código de Conta
 Invoices.LineItems.AccountCode string

Código de conta alfanumérico definido pelo cliente, por exemplo, 200 ou VENDAS
ID da conta
 Invoices.LineItems.AccountId string

Identificador da conta Xero (único dentro das organizações)
Quantidade
 Invoices.LineItems.Quantity number

Quantidade de LineItem
LineItem ID
 Invoices.LineItems.LineItemID string

O identificador Xero gerado para um LineItem
Sub Total
 Invoices.SubTotal number

Total de faturas excluindo impostos
Imposto Total
 Invoices.TotalTax number

Total do imposto na fatura
Total
 Invoices.Total number

Total de impostos da fatura incluídos (ou seja, Subtotal + TotalTax)
Data de atualização UTC
 Invoices.UpdatedDateUTC string

Data da última modificação Formato UTC
Código de Moeda
 Invoices.CurrencyCode string

A moeda em que a fatura foi levantada
Invoices.Type string

Tipo de fatura
ID da fatura
 Invoices.InvoiceID string

Identificador gerado pelo Xero para fatura (único dentro das organizações)
Número da Fatura
 Invoices.InvoiceNumber string

Código alfanumérico único que identifica a fatura
Montante devido
 Invoices.AmountDue number

Montante por pagar na fatura
Valor Pago
 Invoices.AmountPaid number

Soma dos pagamentos recebidos pela fatura
Valor Creditado
 Invoices.AmountCredited number

Soma de todas as notas de crédito, pagamentos em excesso e pré-pagamentos aplicados à fatura
Taxa de câmbio
 Invoices.CurrencyRate number

A taxa de câmbio de uma fatura multimoeda

Iniciar sessão no Xero

ID da Operação:
GetStarted

Inicie sessão na sua conta Xero para começar

Devoluções

Name Caminho Tipo Description
array of object
id
 id string

Id
authEventId
 authEventId string

ID do evento de autenticação
tenantId
 tenantId string

ID do locatário Xero
Tipo de inquilino
 tenantType string

Tipo de locatário
Nome do locatário
 tenantName string

Nome do Inquilino
createdDateUtc
 createdDateUtc string

Data de criação UTC
atualizadoDateUtc
 updatedDateUtc string

Data de atualização UTC

Listar contatos

ID da Operação:
GetContacts

Esta ação permite que você liste os contatos do Xero que correspondem às opções selecionadas

Parâmetros

Name Chave Necessário Tipo Description
Onde filtrar
 where string

Filtrar, por exemplo Name="ABC limited"
Filtrar em ContactIDs
 IDs string

Filtrar em uma lista separada por vírgulas de ContactIDs
Uma resposta leve menor
 summaryOnly boolean

Recupere uma versão menor do objeto de resposta.
Paginação
 page integer

Recuperando uma coleção de faturas usando paginação
Incluir arquivado
 includeArchived boolean

Os contactos com um estado de ARQUIVADO serão incluídos na resposta
Termo de Pesquisa
 searchTerm string

Parâmetro de pesquisa que executa uma pesquisa de texto que não diferencia maiúsculas de minúsculas no campo (Name, FirstName, LastName, ContactNumber, CompanyNumber, EmailAddress)
ID do locatário Xero
 xero-tenant-id True string

Especificar ID do locatário Xero

Devoluções

Name Caminho Tipo Description
Contacts
 Contacts array of object

Contacts
ID de contato
 Contacts.ContactID string

Identificador Xero (único dentro das organizações)
Número de Contacto
 Contacts.ContactNumber string

Este campo é somente leitura na interface do usuário do Xero, usada para identificar contatos em sistemas externos. Ele é exibido como código de contato na interface do usuário de contatos no Xero.
Status do contato
 Contacts.ContactStatus string

Estado atual de um contacto
Nome
 Contacts.Name string

Nome completo do contacto/organização
Nome Próprio
 Contacts.FirstName string

Nome próprio da pessoa de contacto
Apelido
 Contacts.LastName string

Apelido da pessoa de contacto
Endereço de E-mail
 Contacts.EmailAddress string

Endereço de e-mail da pessoa de contacto
Dados da conta bancária
 Contacts.BankAccountDetails string

Número de conta bancária do contacto
Addresses
 Contacts.Addresses array of object

Addresses
EndereçoType
 Contacts.Addresses.AddressType string

Tipo de endereço
City
 Contacts.Addresses.City string

City
Região
 Contacts.Addresses.Region string

Região
Código Postal
 Contacts.Addresses.PostalCode string

Código Postal
Country
 Contacts.Addresses.Country string

Country
AtençãoTo
 Contacts.Addresses.AttentionTo string

Atenção à
Telefones
 Contacts.Phones array of object

Telefones
Tipo de Telefone
 Contacts.Phones.PhoneType string

Tipo de telefone
Número de telefone
 Contacts.Phones.PhoneNumber string

Número de Telefone
PhoneAreaCode
 Contacts.Phones.PhoneAreaCode string

Código de Área do Telefone
TelefoneCountryCode
 Contacts.Phones.PhoneCountryCode string

Telefone Código do país
Data de atualização UTC
 Contacts.UpdatedDateUTC string

Carimbo de data/hora UTC da última atualização para contato
Pessoas de Contacto
 Contacts.ContactPersons array of object

Pessoas de contato adicionais
Nome Próprio
 Contacts.ContactPersons.FirstName string

Nome da pessoa de contacto adicional
Apelido
 Contacts.ContactPersons.LastName string

Apelido da pessoa de contacto adicional
Endereço de E-mail
 Contacts.ContactPersons.EmailAddress string

Endereço de e-mail da pessoa de contato adicional

Listar faturas

ID da Operação:
GetInvoices

Esta ação permite listar as faturas do Xero que correspondem às opções selecionadas

Parâmetros

Name Chave Necessário Tipo Description
ID do locatário Xero
 xero-tenant-id True string

ID do locatário Xero
Onde filtrar
 where string

Filtro, por exemplo Tipo=="ACCPAY" E Estado=="AUTORIZADO"
Filtrar em Status
 Statuses string

Filtre em uma lista de status separada por vírgula. por exemplo- AUTORIZADO, RASCUNHO
Filtrar em IDs
 IDs string

Filtrar numa lista de IDs separada por vírgulas
Filtrar números de fatura
 InvoiceNumbers string

Filtre em uma lista separada por vírgulas do número da fatura.
Filtrar em ids de contato
 ContactIDs string

Filtre em uma lista separada por vírgulas de IDs de contato.
Uma resposta leve menor
 summaryOnly boolean

Recupere uma versão menor do objeto de resposta.
Paginação
 page integer

Recuperando uma coleção de faturas usando paginação

Devoluções

Name Caminho Tipo Description
Invoices
 Invoices array of object

Invoices
ID de contato
 Invoices.Contact.ContactID string

Identificador de contato Xero
Nome
 Invoices.Contact.Name string

Nome completo do contacto/organização
Date
 Invoices.Date string

Data de emissão da fatura – AAAA-MM-DD
Data Para Conclusão
 Invoices.DueDate string

Data de vencimento da fatura – AAAA-MM-DD
Estado da fatura
 Invoices.Status string

Estado da fatura (RASCUNHO, SUBMETIDO, AUTORIZADO)
Tipos de quantidade de linha
 Invoices.LineAmountTypes string

Tipos de valor de linha (exclusivo, inclusive, sem imposto)
Itens de linha
 Invoices.LineItems array of object

Itens de linha
Description
 Invoices.LineItems.Description string

Descrição do item de linha
Montante unitário
 Invoices.LineItems.UnitAmount number

Valor unitário do item de linha
Tipo de Imposto
 Invoices.LineItems.TaxType string

Usado como uma substituição se o Código de Imposto padrão para o AccountCode selecionado não estiver correto
Valor do Imposto
 Invoices.LineItems.TaxAmount number

O valor do imposto é calculado automaticamente como uma porcentagem do valor da linha (veja abaixo) com base na taxa de imposto.
Montante de Linha
 Invoices.LineItems.LineAmount number

O valor da linha reflete o preço descontado se uma DiscountRate tiver sido usada
Código de Conta
 Invoices.LineItems.AccountCode string

Código de conta alfanumérico definido pelo cliente, por exemplo, 200 ou VENDAS
ID da conta
 Invoices.LineItems.AccountId string

Identificador da conta Xero (único dentro das organizações)
Quantidade
 Invoices.LineItems.Quantity number

Quantidade de LineItem
LineItem ID
 Invoices.LineItems.LineItemID string

O identificador Xero gerado para um LineItem
Sub Total
 Invoices.SubTotal number

Total de faturas excluindo impostos
Imposto Total
 Invoices.TotalTax number

Total do imposto na fatura
Total
 Invoices.Total number

Total de impostos da fatura incluídos (ou seja, Subtotal + TotalTax)
Data de atualização UTC
 Invoices.UpdatedDateUTC string

Data da última modificação Formato UTC
Código de Moeda
 Invoices.CurrencyCode string

A moeda em que a fatura foi levantada
Invoices.Type string

Tipo de fatura
ID da fatura
 Invoices.InvoiceID string

Identificador gerado pelo Xero para fatura (único dentro das organizações)
Número da Fatura
 Invoices.InvoiceNumber string

Código alfanumérico único que identifica a fatura
Montante devido
 Invoices.AmountDue number

Montante por pagar na fatura
Valor Pago
 Invoices.AmountPaid number

Soma dos pagamentos recebidos pela fatura
Valor Creditado
 Invoices.AmountCredited number

Soma de todas as notas de crédito, pagamentos em excesso e pré-pagamentos aplicados à fatura
Taxa de câmbio
 Invoices.CurrencyRate number

A taxa de câmbio de uma fatura multimoeda
Totalmente pago na data
 Invoices.FullyPaidOnDate string

A data em que a fatura foi integralmente paga
Payments
 Invoices.Payments array of object

Payments
ID de pagamento em lote
 Invoices.Payments.BatchPaymentID string

Apresentar se o pagamento foi criado como parte de um lote
ID de pagamento
 Invoices.Payments.PaymentID string

Identificador Xero gerado para pagamento (único dentro das organizações)
Date
 Invoices.Payments.Date string

Data de pagamento (AAAA-MM-DD), por exemplo, 2009-09-06
Montante
 Invoices.Payments.Amount number

O montante do pagamento
Taxa de câmbio
 Invoices.Payments.CurrencyRate number

Taxa de câmbio quando o pagamento é recebido