Dados de Faturação JSON #
As informações abaixo fornecem detalhes do JSON dados fornecidos aquando do descarregamento dos dados de uma fatura específica. O JSON Os dados fornecem o nível mais granular de informações, incluindo entradas para cada licença de usuário usada e entradas resumidas que fornecem informações sobre totais de faturas e impostos aplicáveis.
Esquema de detalhes da fatura #
O principal JSON Entrada fornece detalhes sobre o número da fatura, período e data. Ele também contém uma matriz dos itens de fatura individuais relacionados a cada licença que está sendo faturada.
| Chave | Descrição | Tipo |
|---|---|---|
| inquilino | O id da conta de revendedor principal | string |
| ID da fatura | Um número exclusivo para identificar uma fatura específica | string |
| Número da fatura | O número da fatura exibido no PDF fatura | string |
| nome da conta | O nome da empresa para a conta de revendedor principal | string |
| BillingPeriodStart | A data de início do período de faturação | string |
| billingperiodend | A data de término do período de faturamento | string |
| valor da fatura | O valor total da fatura | duplo |
| itens da fatura | Uma coleção de itens de fatura | array(Item da fatura) |
JSON Esquema de item de fatura #
Cada entrada de item da fatura no JSON Os dados de faturamento fornecem os parâmetros listados abaixo. Referem-se a uma utilização individual por parte de um utilizador com os intervalos de datas aplicáveis.
| Chave | Descrição | Tipo |
|---|---|---|
| ID | Um id exclusivo para a compra individual | string |
| quantidade1 | A quantidade utilizada | duplo |
| valor | O custo do item | duplo |
| a partir da data | A data a partir da qual o item está sendo cobrado | string |
| até à data | A data a partir da qual o item está sendo cobrado para | string |
| ordem de cálculo | Número sequencial que indica a ordem em que os itens da fatura devem ser processados | Int |
| UsuárioUsado | Indica como o valor do item da fatura está sendo aplicado à fatura | Operador de item de fatura |
| operatorvalueused | Indica o valor do operador ADJUSTPERCENTAGE | duplo |
| producttagname | O nome do recurso/produto para o qual o Item de Fatura se destina. Este será no formato '{PRODUCT_NAME} #{PART_NUMBER}' | string |
| billingoutputtags | Indicação se o Item da Fatura é para uma compra ou é um campo de resumo | matriz(string) |
| stringvalues | Fornece informações sobre o cliente e o usuário final para o qual a compra se destina | KeyValuePair< string,string> |
| valores numéricos | Fornece informações sobre o cliente e o usuário final para o qual a compra se destina | KeyValuePair< string, duplo> |
Operadores de item de fatura #
O operador de cada item indica como o item está sendo aplicado à fatura. PurchaseResult terá um PREÇO para identificar o custo do item. Os itens com outras tags de saída indicarão se estão somando o valor da fatura ou aplicando um valor percentual aos itens anteriores, como o imposto sobre vendas.
| Rubricas | Descrição |
|---|---|
| PREÇO | Indica que o item da fatura está mostrando o preço unitário de um item |
| SOMA | Indica que o Item da Fatura está mostrando um total de vários itens |
| PERCENTAGEM DE AJUSTAMENTO | Indica que o item da fatura está mostrando um ajuste percentual para a SOMA, isso geralmente indica que o IVA está sendo aplicado |
Itens de etiqueta de saída de faturamento #
As etiquetas de saída de faturação são utilizadas para indicar se a entrada de dados está relacionada com uma compra ou se é uma entrada resumida que fornece informações sobre toda a fatura.
| Rubricas | Descrição |
|---|---|
| CompraResultado | Indica que o item da fatura é uma compra exigível |
| Resumo | Indica que o Item da Fatura é um resumo das compras, fornecendo informações sobre o total da fatura. Quando por si só sem as etiquetas 'TotalVAT' ou 'TotalInclVAT', indica o total da fatura antes de o IVA ser adicionado. |
| TotalInclIVA | Indica que o item da fatura está mostrando o total da fatura, incluindo qualquer IVA aplicável |
| IVA total | Indica que o Item da Fatura está mostrando o IVA total aplicável para a fatura |
Itens de valor de cadeia de caracteres #
Os itens de valor de cadeia de caracteres fornecem informações específicas para o cliente e o usuário final do item comprado.
| Chave | Descrição | |
|---|---|---|
| TenantCode2 | O ID do locatário do revendedor | |
| TenantCodeext2 | A referência do revendedor para o revendedor | |
| TenantName2 | O nome do revendedor | string |
| Código do revendedor | ID do locatário do revendedor | |
| ResellerCodeExt | A referência estendida para o revendedor | |
| Nome do Revendedor | O nome do revendedor | |
| Id do usuário | O id do usuário | |
| Nome de utilizador | O nome de usuário do usuário | |
| Função | A chave de função para o item faturado |
Itens de valor numérico #
Os itens de valor numérico fornecem informações específicas para o cliente e usuário final do item comprado.
| Chave | Descrição |
|---|---|
| customer_licence_count | O número total dessas licenças que o cliente tem |
Exemplo JSON Realização #
{
"tenantId": "00000000-0000-0000-0000-123456789123",
"invoiceId": "00000000000000000000000a",
"Número da fatura": "9000004",
"accountName": "Exemplo de Inquilino 1",
"billingPeriodStart": "2020-04-01T00:00:00.0000000",
"billingPeriodEnd": "2020-04-30T23:59:59.0000000",
"invoiceDate": "2020-04-09T00:00:00.0000000",
"invoiceValue": 17,50,
"invoiceItems": \[
{
"id": "000000000000000000000001",
"quantidade": 1.0,
"valor": 1,25,
"fromDate": "2020-04-01T00:00:00.000+00:00",
"toDate": "2020-04-30T23:59:59.000+00:00",
"calculationOrder": 1,
"operadorUsado": "PREÇO",
"operatorValueUsed": 1.25,
"productTagName": "Utilizador Essencial #XDM00001",
"billingOutputTags": ["PurchaseResult"][ "PurchaseResult" ],
"stringValues": [
{
"nome": "Função",
"valor": "customer.user.pbx"
},
{
"nome": "ResellerCode",
"valor": "00000000-0000-0000-0000-000000000222"
},
{
"nome": "ResellerCodeExt",
"valor": "revendedor ref 1"
},
{
"nome": "ResellerName",
"valor": "Revendedor ABC"
},
{
"nome": "TenantCode",
"valor": "00000000-0000-0000-0000-000000000111"
},
{
"nome": "TenantCodeExt",
"valor": "ref personalizado 1"
},
{
"nome": "TenantName",
"value": "Cliente de exemplo 1"
},
{
"nome": "UserId",
"valor": "00000000-0000-0000-0000-000000000001"
},
{
"nome": "Nome de Utilizador",
"valor": "[email protected]"
}
][
{
"name": "Role",
"value": "customer.user.pbx"
},
{
"name": "ResellerCode",
"value": "00000000-0000-0000-0000-000000000222"
},
{
"name": "ResellerCodeExt",
"value": "reseller ref 1"
},
{
"name": "ResellerName",
"value": "ABC Reseller"
},
{
"name": "TenantCode",
"value": "00000000-0000-0000-0000-000000000111"
},
{
"name": "TenantCodeExt",
"value": "custom ref 1"
},
{
"name": "TenantName",
"value": "Example Customer 1"
},
{
"name": "UserId",
"value": "00000000-0000-0000-0000-000000000001"
},
{
"name": "UserName",
"value": "[email protected]"
}
],
"numericValues": [
{
"nome": "customer_licence_count",
"valor": 1
}
][
{
"name": "customer_licence_count",
"value": 1
}
]
},
{
"id": "000000000000000000000003",
"quantidade": 1.0,
"valor": 15,0,
"fromDate": "2020-04-01T00:00:00.000+00:00",
"toDate": "2020-04-30T23:59:59.000+00:00",
"calculationOrder": 3,
"operadorUsado": "PREÇO",
"operatorValueUsed": 15,00,
"productTagName": "Supervisor em Tempo Real #XDM00010",
"billingOutputTags": ["PurchaseResult"][ "PurchaseResult" ],
"stringValues": [
{
"nome": "Função",
"valor": "customer.user.supervisorl2"
},
{
"nome": "ResellerCode",
"valor": "00000000-0000-0000-0000-000000000222"
},
{
"nome": "ResellerCodeExt",
"valor": "revendedor ref 1"
},
{
"nome": "ResellerName",
"valor": "Revendedor ABC"
},
{
"nome": "TenantCode",
"valor": "00000000-0000-0000-0000-000000000111"
},
{
"nome": "TenantCodeExt",
"valor": "ref personalizado 1"
},
{
"nome": "TenantName",
"value": "Cliente de exemplo 1"
},
{
"nome": "UserId",
"valor": "00000000-0000-0000-0000-000000000001"
},
{
"nome": "Nome de Utilizador",
"valor": "[email protected]"
}
][
{
"name": "Role",
"value": "customer.user.supervisorl2"
},
{
"name": "ResellerCode",
"value": "00000000-0000-0000-0000-000000000222"
},
{
"name": "ResellerCodeExt",
"value": "reseller ref 1"
},
{
"name": "ResellerName",
"value": "ABC Reseller"
},
{
"name": "TenantCode",
"value": "00000000-0000-0000-0000-000000000111"
},
{
"name": "TenantCodeExt",
"value": "custom ref 1"
},
{
"name": "TenantName",
"value": "Example Customer 1"
},
{
"name": "UserId",
"value": "00000000-0000-0000-0000-000000000001"
},
{
"name": "UserName",
"value": "[email protected]"
}
],
"numericValues": [
{
"nome": "customer_licence_count",
"valor": 1
}
][
{
"name": "customer_licence_count",
"value": 1
}
]
},
{
"id": "000000000000000000000004",
"quantidade": 3.0,
"valor": 17,50,
"fromDate": "2020-04-01T00:00:00.000+00:00",
"toDate": "2020-04-30T23:59:59.000+00:00",
"calculationOrder": 4,
"operadorUsado": "SOMA",
"operatorValueUsed": 0,0,
"productTagName": "Todos os Produtos",
"billingOutputTags": ["Resumo", "Total", "GL", "GL_Entry:0000; crédito;"][ "Summary", "Total", "GL", "GL_Entry:0000;credit;" ],
"stringValues": [][ ]
},
{
"id": "000000000000000000000005",
"quantidade": 3.0,
"valor": 17,50,
"fromDate": "2020-04-01T00:00:00.000+00:00",
"toDate": "2020-04-30T23:59:59.000+00:00",
"calculationOrder": 5,
"operadorUsado": "ADJUSTPERCENTAGE",
"operatorValueUsed": 0,0,
"productTagName": "Todos os Produtos",
"billingOutputTags": ["TotalInclVAT", "Resumo", "GL_Balance", "GL_Entry:2222; débito; Devedores"][ "TotalInclVAT", "Summary", "GL_Balance", "GL_Entry:2222;debit;Debtors" ],
"stringValues": [][ ]
},
{
"id": "000000000000000000000006",
"quantidade": 345,0,
"valor": 0,0,
"fromDate": "2020-04-01T00:00:00.000+00:00",
"toDate": "2020-04-30T23:59:59.000+00:00",
"calculationOrder": 6,
"operadorUsado": "ADJUSTPERCENTAGE",
"operatorValueUsed": 0,0,
"productTagName": "Todos os Produtos",
"billingOutputTags": ["TotalIVA", "Sumário", "GL_VAT", "IVA:S", "GL_Entry:1111; crédito; IVA"][ "TotalVAT", "Summary", "GL_VAT", "VAT:S", "GL_Entry:1111;credit;VAT" ],
"stringValues": [][ ]
}
],
"Tipo de fatura": 0
}