SureXeroLite (Editor Independente) (versão prévia)
Desbloqueie o poder de um conector versátil projetado para configuração sem esforço e integração perfeita em seus aplicativos comerciais preferenciais. 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.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – 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 |
| support@848.co |
| Metadados do conector | |
|---|---|
| Publicador | O grupo 848 |
| Site | https://www.xero.com |
| Política de privacidade | https://www.xero.com/uk/legal/privacy |
| Categorias | Produtividade; Financiar |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Adicionar um novo contato |
Essa ação permite que você adicione um novo contato no Xero |
| Adicionar uma nova fatura |
Essa ação permite que você adicione uma nova fatura no Xero |
| Entrar no Xero |
Faça logon em sua conta do Xero para começar |
| Listar contatos |
Essa ação permite listar os contatos do Xero que correspondem às opções selecionadas |
| Listar faturas |
Essa ação permite listar as faturas do Xero que correspondem às opções selecionadas |
Adicionar um novo contato
Essa ação permite que você adicione um novo contato no Xero
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do Xero
|
xero-tenant-id | True | string |
ID do locatário do Xero |
|
Nome
|
Name | True | string |
Nome completo do contato/organização |
|
Primeiro Nome
|
FirstName | string |
Nome do contato primário |
|
|
Apelido
|
LastName | string |
Sobrenome do contato primário |
|
|
Endereço de Email
|
EmailAddress | string |
Endereço de email de contato primário |
|
|
Tipo de imposto a receber contas
|
AccountsReceivableTaxType | string |
Tipo de imposto padrão usado para contato em faturas AR |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contatos
|
Contacts | array of object |
Contatos |
|
ID de contato
|
Contacts.ContactID | string |
Identificador Xero |
|
Número do contato
|
Contacts.ContactNumber | string |
Número para identificar contatos em sistemas externos |
|
Status do Contato
|
Contacts.ContactStatus | string |
Status atual de um contato |
|
Nome
|
Contacts.Name | string |
Nome completo do contato/organização |
|
Primeiro Nome
|
Contacts.FirstName | string |
Nome do contato primário |
|
Apelido
|
Contacts.LastName | string |
Sobrenome do contato primário |
|
Endereço de Email
|
Contacts.EmailAddress | string |
Endereço de email de contato primário |
|
Detalhes da conta bancária
|
Contacts.BankAccountDetails | string |
Número de contato da conta bancária |
|
Addresses
|
Contacts.Addresses | array of object |
Endereços para um contato |
|
AddressType
|
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 |
|
País
|
Contacts.Addresses.Country | string |
País |
|
Telefones
|
Contacts.Phones | array of object |
Telefones para um contato |
|
PhoneType
|
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 da área do telefone |
|
PhoneCountryCode
|
Contacts.Phones.PhoneCountryCode | string |
Código do país do telefone |
|
|
Contacts.UpdatedDateUTC | string |
Data atualizada UTC |
|
ContactPersons
|
Contacts.ContactPersons | array of object |
Pessoas de contato additonal |
|
Primeiro Nome
|
Contacts.ContactPersons.FirstName | string |
Nome da pessoa de contato adicional |
|
Apelido
|
Contacts.ContactPersons.LastName | string |
Sobrenome da pessoa de contato additonal |
|
Endereço de Email
|
Contacts.ContactPersons.EmailAddress | string |
Endereço de email da pessoa de contato additonal |
Adicionar uma nova fatura
Essa ação permite que você adicione uma nova fatura no Xero
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do Xero
|
xero-tenant-id | True | string |
ID do locatário do Xero |
|
Date
|
Date | string |
Fatura de data emitida – YYYY-MM-DD |
|
|
Data de vencimento
|
DueDate | string |
A fatura de data é vencida – YYYY-MM-DD |
|
|
Tipo de fatura
|
Type | True | string |
Tipo de fatura (ACCREC – fatura de vendas ou fatura do cliente, fatura accpay-a ou fatura do fornecedor) |
|
Número de referência adicional
|
Reference | string |
Somente ACCREC – número de referência adicional |
|
|
ID de contato
|
ContactID | True | string |
Identificador Xero (exclusivo dentro das organizações) |
|
Tipos de quantidade de linha
|
LineAmountTypes | string |
Os valores de linha são exclusivos do imposto por padrão se você não especificar esse elemento. (Exclusivo, Inclusivo, NoTax). |
|
|
Número da fatura
|
InvoiceNumber | string |
Código numérico alfa exclusivo identificando 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 do item de linha
|
UnitAmount | True | number |
Valor da unidade do item de linha |
|
Código da conta do item de linha
|
AccountCode | string |
Código da conta alfa numérica definida pelo cliente, por exemplo, 200 ou SALES |
|
|
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 gerada |
|
|
Taxa de Moeda
|
CurrencyRate | number |
A taxa de moeda de uma fatura multicurrency |
|
|
Status da fatura
|
Status | string |
Status da fatura (RASCUNHO, ENVIADO, AUTORIZADO) |
|
|
Data de pagamento esperada
|
ExpectedPaymentDate | string |
Mostrado em faturas de vendas (contas a receber) quando isso tiver sido definido |
Retornos
| Nome | 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 contato/organização |
|
Date
|
Invoices.Date | string |
Fatura de data emitida – YYYY-MM-DD |
|
Data de vencimento
|
Invoices.DueDate | string |
A fatura de data é vencida – YYYY-MM-DD |
|
Status da fatura
|
Invoices.Status | string |
Status da fatura (RASCUNHO, ENVIADO, AUTORIZADO) |
|
Tipos de quantidade de linha
|
Invoices.LineAmountTypes | string |
Tipos de quantidade de linha (Exclusivo, Inclusivo, NoTax) |
|
LineItems
|
Invoices.LineItems | array of object |
LineItems |
|
Description
|
Invoices.LineItems.Description | string |
Descrição do item de linha |
|
Valor da Unidade
|
Invoices.LineItems.UnitAmount | number |
Valor da unidade de lineitem |
|
Tipo de imposto
|
Invoices.LineItems.TaxType | string |
Usado como uma substituição se o Código Tributário padrão para o AccountCode selecionado não estiver correto |
|
Valor do Imposto
|
Invoices.LineItems.TaxAmount | number |
O valor do imposto é calculado automaticamente como um percentual do valor da linha (veja abaixo) com base na taxa de imposto. |
|
Valor da Linha
|
Invoices.LineItems.LineAmount | number |
O valor da linha refletirá o preço com desconto se uma Taxa de Desconto tiver sido usada |
|
Código da conta
|
Invoices.LineItems.AccountCode | string |
Código da conta alfa numérica definida pelo cliente, por exemplo, 200 ou SALES |
|
ID da conta
|
Invoices.LineItems.AccountId | string |
Identificador de conta Xero (exclusivo dentro das organizações) |
|
Quantidade
|
Invoices.LineItems.Quantity | number |
Quantidade de LineItem |
|
LineItem ID
|
Invoices.LineItems.LineItemID | string |
O identificador gerado pelo Xero para um LineItem |
|
Sub-Total
|
Invoices.SubTotal | number |
Total de faturas excluindo impostos |
|
Imposto Total
|
Invoices.TotalTax | number |
Imposto total na fatura |
|
Total
|
Invoices.Total | number |
Total de impostos de fatura inclusiva (ou seja, SubTotal + TotalTax) |
|
Data atualizada UTC
|
Invoices.UpdatedDateUTC | string |
Formato UTC da data da última modificação |
|
Código de moeda
|
Invoices.CurrencyCode | string |
A moeda em que a fatura foi gerada |
|
|
Invoices.Type | string |
Tipo de fatura |
|
ID da fatura
|
Invoices.InvoiceID | string |
Identificador gerado pelo Xero para fatura (exclusivo dentro de organizações) |
|
Número da fatura
|
Invoices.InvoiceNumber | string |
Código numérico alfa exclusivo identificando fatura |
|
Valor devido
|
Invoices.AmountDue | number |
Valor restante a ser pago na fatura |
|
Valor pago
|
Invoices.AmountPaid | number |
Soma dos pagamentos recebidos para fatura |
|
Valor Creditado
|
Invoices.AmountCredited | number |
Soma de todas as notas de crédito, pagamentos excessivos e pré-pagamentos aplicados à fatura |
|
Taxa de Moeda
|
Invoices.CurrencyRate | number |
A taxa de moeda de uma fatura multicurrency |
Entrar no Xero
Faça logon em sua conta do Xero para começar
Retornos
| Nome | 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 do Xero |
|
tenantType
|
tenantType | string |
Tipo de locatário |
|
tenantName
|
tenantName | string |
Nome do locatário |
|
createdDateUtc
|
createdDateUtc | string |
Data de Criação UTC |
|
updatedDateUtc
|
updatedDateUtc | string |
Data atualizada UTC |
Listar contatos
Essa ação permite listar os contatos do Xero que correspondem às opções selecionadas
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filtro de Onde
|
where | string |
Filtro, 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 |
Contatos com um status de ARCHIVED 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 do Xero
|
xero-tenant-id | True | string |
Especificar a ID do locatário do Xero |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contatos
|
Contacts | array of object |
Contatos |
|
ID de contato
|
Contacts.ContactID | string |
Identificador Xero (exclusivo dentro das organizações) |
|
Número do contato
|
Contacts.ContactNumber | string |
Esse campo é lido apenas 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 contatos no Xero. |
|
Status do Contato
|
Contacts.ContactStatus | string |
Status atual de um contato |
|
Nome
|
Contacts.Name | string |
Nome completo do contato/organização |
|
Primeiro Nome
|
Contacts.FirstName | string |
Nome da pessoa de contato |
|
Apelido
|
Contacts.LastName | string |
Sobrenome da pessoa de contato |
|
Endereço de Email
|
Contacts.EmailAddress | string |
Endereço de email da pessoa de contato |
|
Detalhes da conta bancária
|
Contacts.BankAccountDetails | string |
Número de contato da conta bancária |
|
Addresses
|
Contacts.Addresses | array of object |
Addresses |
|
AddressType
|
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 |
|
País
|
Contacts.Addresses.Country | string |
País |
|
AttentionTo
|
Contacts.Addresses.AttentionTo | string |
Atenção para |
|
Telefones
|
Contacts.Phones | array of object |
Telefones |
|
PhoneType
|
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 da área do telefone |
|
PhoneCountryCode
|
Contacts.Phones.PhoneCountryCode | string |
Código do país do telefone |
|
Data atualizada UTC
|
Contacts.UpdatedDateUTC | string |
Carimbo de data/hora UTC da última atualização para contato |
|
ContactPersons
|
Contacts.ContactPersons | array of object |
Pessoas de contato additonal |
|
Primeiro Nome
|
Contacts.ContactPersons.FirstName | string |
Nome da pessoa de contato adicional |
|
Apelido
|
Contacts.ContactPersons.LastName | string |
Sobrenome da pessoa de contato additonal |
|
Endereço de Email
|
Contacts.ContactPersons.EmailAddress | string |
Endereço de email da pessoa de contato additonal |
Listar faturas
Essa ação permite listar as faturas do Xero que correspondem às opções selecionadas
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do locatário do Xero
|
xero-tenant-id | True | string |
ID do locatário do Xero |
|
Filtro de Onde
|
where | string |
Filtro, por exemplo Type=="ACCPAY" AND Status=="AUTHORISED" |
|
|
Filtrar em Status
|
Statuses | string |
Filtre em uma lista separada por vírgulas de status. por exemplo: AUTHORISED, DRAFT |
|
|
Filtrar em IDs
|
IDs | string |
Filtrar em uma lista separada por vírgulas de IDs |
|
|
Filtrar os números da 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 |
Retornos
| Nome | 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 contato/organização |
|
Date
|
Invoices.Date | string |
Fatura de data emitida – YYYY-MM-DD |
|
Data de vencimento
|
Invoices.DueDate | string |
A fatura de data é vencida – YYYY-MM-DD |
|
Status da fatura
|
Invoices.Status | string |
Status da fatura (RASCUNHO, ENVIADO, AUTORIZADO) |
|
Tipos de quantidade de linha
|
Invoices.LineAmountTypes | string |
Tipos de quantidade de linha (Exclusivo, Inclusivo, NoTax) |
|
LineItems
|
Invoices.LineItems | array of object |
LineItems |
|
Description
|
Invoices.LineItems.Description | string |
Descrição do item de linha |
|
Valor da Unidade
|
Invoices.LineItems.UnitAmount | number |
Valor da unidade de lineitem |
|
Tipo de imposto
|
Invoices.LineItems.TaxType | string |
Usado como uma substituição se o Código Tributário padrão para o AccountCode selecionado não estiver correto |
|
Valor do Imposto
|
Invoices.LineItems.TaxAmount | number |
O valor do imposto é calculado automaticamente como um percentual do valor da linha (veja abaixo) com base na taxa de imposto. |
|
Valor da Linha
|
Invoices.LineItems.LineAmount | number |
O valor da linha refletirá o preço com desconto se uma Taxa de Desconto tiver sido usada |
|
Código da conta
|
Invoices.LineItems.AccountCode | string |
Código da conta alfa numérica definida pelo cliente, por exemplo, 200 ou SALES |
|
ID da conta
|
Invoices.LineItems.AccountId | string |
Identificador de conta Xero (exclusivo dentro das organizações) |
|
Quantidade
|
Invoices.LineItems.Quantity | number |
Quantidade de LineItem |
|
LineItem ID
|
Invoices.LineItems.LineItemID | string |
O identificador gerado pelo Xero para um LineItem |
|
Sub-Total
|
Invoices.SubTotal | number |
Total de faturas excluindo impostos |
|
Imposto Total
|
Invoices.TotalTax | number |
Imposto total na fatura |
|
Total
|
Invoices.Total | number |
Total de impostos de fatura inclusiva (ou seja, SubTotal + TotalTax) |
|
Data atualizada UTC
|
Invoices.UpdatedDateUTC | string |
Formato UTC da data da última modificação |
|
Código de moeda
|
Invoices.CurrencyCode | string |
A moeda em que a fatura foi gerada |
|
|
Invoices.Type | string |
Tipo de fatura |
|
ID da fatura
|
Invoices.InvoiceID | string |
Identificador gerado pelo Xero para fatura (exclusivo dentro de organizações) |
|
Número da fatura
|
Invoices.InvoiceNumber | string |
Código numérico alfa exclusivo identificando fatura |
|
Valor devido
|
Invoices.AmountDue | number |
Valor restante a ser pago na fatura |
|
Valor pago
|
Invoices.AmountPaid | number |
Soma dos pagamentos recebidos para fatura |
|
Valor Creditado
|
Invoices.AmountCredited | number |
Soma de todas as notas de crédito, pagamentos excessivos e pré-pagamentos aplicados à fatura |
|
Taxa de Moeda
|
Invoices.CurrencyRate | number |
A taxa de moeda de uma fatura multicurrency |
|
Data totalmente paga
|
Invoices.FullyPaidOnDate | string |
A data em que a fatura foi totalmente 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 gerado pelo Xero para pagamento (exclusivo dentro das organizações) |
|
Date
|
Invoices.Payments.Date | string |
Data em que o pagamento está sendo feito (YYYY-MM-DD) por exemplo, 2009-09-06 |
|
Quantidade
|
Invoices.Payments.Amount | number |
O valor do pagamento |
|
Taxa de Moeda
|
Invoices.Payments.CurrencyRate | number |
Taxa de câmbio quando o pagamento é recebido |