invantive documentation
Invantive SupportforenAnmelden / Eintragen

TimeReportingArticles: Fortnox Time Reporting Articles

read only REST

  • Katalog: Fortnox
  • Schema: TimeReportingArticles
  • Label: Time Reporting Articles

Get full article registrations that match filter

Response property descriptions:

     id - The unique id of a basic common combination of article registrations. (The basic common combination means "user/purchase date/customer/project/cost center", which leads to a dialog with several article registrations.)

     purchaseDate - The date on which the article is purchased or registered for charging.

     ownerId - The user ID who creates the basic common combination.

     version - The version of the basic common combination (article dialog) being updated, which is used for handling the concurrency issue.

     registrationType - It is always "ARTICLE" for article list endpoint.

     Sub-Class - ArticleRegistration:

         id - The unique id of an article registration.

         registrationId - The id of the basic common combination.

         orderIndex - the order index for the article registration in regard of the common combination.

         ownerId - The user ID who owns the article registration.

         totalQuantity - The quantity of the article.

         unitPrice - The unit price connected to the article registration, which might be locked on an invoice/order basis or for non-invoiceable.

         unitCost - The unit cost connected to the article registration, which might be locked on an invoice/order basis.

         invoiceBasisId - The ID of invoice/order basis which is used for creating an invoice/order.

         nonInvoiceable - If the article registration would be ignored for charging or not.

         note - The note on the article registration.

         documentId - The document ID which includes the article registration and is created in Invoicing application.

         documentType - The document type which could be "invoice" or "order".

Es können nur Daten abgerufen werden.

Zusammenfassung

Response property descriptions:
     id - The unique id of a basic common combination of article registrations. (The basic common combination means "user/purchase date/customer/project/cost center", which leads to a dialog with several article registrations.)
     purchaseDate - The date on which the article is purchased or registered for charging.
     ownerId - The user ID who creates the basic common combination.
     version - The version of the basic common combination (article dialog) being updated, which is used for handling the concurrency issue.
     registrationType - It is always "ARTICLE" for article list endpoint.
     Sub-Class - ArticleRegistration:
         id - The unique id of an article registration.
         registrationId - The id of the basic common combination.
         orderIndex - the order index for the article registration in regard of the common combination.
         ownerId - The user ID who owns the article registration.
         totalQuantity - The quantity of the article.
         unitPrice - The unit price connected to the article registration, which might be locked on an invoice/order basis or for non-invoiceable.
         unitCost - The unit cost connected to the article registration, which might be locked on an invoice/order basis.
         invoiceBasisId - The ID of invoice/order basis which is used for creating an invoice/order.
         nonInvoiceable - If the article registration would be ignored for charging or not.
         note - The note on the article registration.
         documentId - The document ID which includes the article registration and is created in Invoicing application.
         documentType - The document type which could be "invoice" or "order".

API-Quelle

  • Endpunkt: /api/time/articles-v1
  • Operation: get /api/time/articles-v1

Leistungsmerkmale

Characteristic Value
Durchschnittliche Zugriffsverzögerung (ms) 356
Anzahl der Vollscan-Zeilen pro Minute 85,000
Anzahl der Query-Zeilen pro Minute 168

Das Ergebnis kann auf dem Client im Cache zwischengespeichert werden.

Parameter

Name Datentyp Required Default Documentation
financialyear `` Selects what financial year that should be used (does not work on every table).
financialyeardate `` Selects by date, what financial year that should be used (does not work on every table).
fromDate `` The start date of the search span, the max of which should be 1 year to the end date ("toDate").Example: 2022-11-01
fromdate2 `` Defines a selection based on a start date.Only available for invoices, orders, offers, vouchers and supplierinvoices (does not work on every table).
includeNonInvoiceablePrice `` If the price of the non-invoiceable article registration is included, or not.
includeRegistrationsWithoutProject `` If the article registration without project is included, or not.
inInvoiceBasis `` If the article registration is locked on an invoice basis, or not.
internalArticles `` If the article registration is internal, which is registered on an internal customer, or not.
invoiced `` If a document is created with the article registration, or not.
lastmodified `` Retrieves all records since the provided timestamp (does not work on every table).
nonInvoiceable `` If the article registration has been moved to non-invoiceable, or not.
toDate `` The end date of the search span, the max of which should be 1 year back to the start date ("fromDate").Example: 2022-11-30
todate2 `` Defines a selection based on an end date.Only available for invoices, orders, offers, vouchers and supplierinvoices (does not work on every table).

Tabellenspalten

Die Spalten der Tabelle TimeReportingArticles sind unten aufgeführt. Jede Spalte hat einen SQL-Datentyp. Beim Einfügen und Aktualisieren muss für jede erforderliche Spalte jederzeit ein neuer Wert angegeben werden der nicht Null ist.

Name Datentyp Label Required Marks Documentation
costCenter_active varchar2 Kostenstelle aktiv Filter auf der Plattform, beschreibbar, costCenter.active
costCenter_id varchar2(40) Kostenstellen-ID Filter auf der Plattform, beschreibbar, costCenter.id
costCenter_name varchar2(255) Name der Kostenstelle Filter auf der Plattform, beschreibbar, costCenter.name
createdTime datetime Erstellungszeit Filter auf der Plattform, beschreibbar, createdTime
customer_accountManager varchar2 Kundenbetreuer Filter auf der Plattform, beschreibbar, customer.accountManager
customer_active char Kunde aktiv Filter auf der Plattform, beschreibbar, customer.active
customer_defaultProjectId varchar2 Standard-Projekt-ID des Kunden Filter auf der Plattform, beschreibbar, customer.defaultProjectId
customer_deleted char Kunde gelöscht Filter auf der Plattform, beschreibbar, customer.deleted
customer_id varchar2(40) Kunden-ID Filter auf der Plattform, beschreibbar, customer.id
customer_invoiceCity varchar2 Rechnungsadresse des Kunden am Ort Filter auf der Plattform, beschreibbar, customer.invoiceCity
customer_invoiceZipCode varchar2 Postleitzahl der Kundenrechnung Filter auf der Plattform, beschreibbar, customer.invoiceZipCode
customer_isBusiness int32 Der Kunde ist das Geschäft Filter auf der Plattform, beschreibbar, customer.isBusiness
customer_name varchar2(255) Name des Kunden Filter auf der Plattform, beschreibbar, customer.name
customer_number varchar2(1024) Kundennummer Filter auf der Plattform, beschreibbar, customer.number
customer_priceList varchar2 Kundenpreisliste Filter auf der Plattform, beschreibbar, customer.priceList
customer_propertyDesignation varchar2 Kennzeichnung von Kundeneigentum Filter auf der Plattform, beschreibbar, customer.propertyDesignation
id guid ID Filter auf der Plattform, beschreibbar, id
ownerId varchar2 Besitzer ID Filter auf der Plattform, beschreibbar, ownerId
ownerName varchar2 itgen_fnx_ownername Filter auf der Plattform, beschreibbar, ownerName
project_description varchar2(50) Projektbeschreibung Filter auf der Plattform, beschreibbar, project.description
project_endDate datetime Projektende Filter auf der Plattform, beschreibbar, project.endDate
project_id varchar2(40) Projekt ID Filter auf der Plattform, beschreibbar, project.id
project_invoicedAmount double Rechnungsbetrag des Projekts Filter auf der Plattform, beschreibbar, project.invoicedAmount
project_orderAmount double Auftragswert des Projekts Filter auf der Plattform, beschreibbar, project.orderAmount
project_orderTime double Projekt-Auftragszeit Filter auf der Plattform, beschreibbar, project.orderTime
project_projectLeader varchar2 Projektleiter Filter auf der Plattform, beschreibbar, project.projectLeader
project_startDate datetime Projektstartdatum Filter auf der Plattform, beschreibbar, project.startDate
project_status int32 Projektstatus Filter auf der Plattform, beschreibbar, project.status
project_totalAmountInInvoices double Gesamtbetrag des Projekts in Rechnungen Filter auf der Plattform, beschreibbar, project.totalAmountInInvoices
purchaseDate datetime Kaufdatum Filter auf der Plattform, beschreibbar, purchaseDate
registeredArticle_createdBy varchar2 Registrierter Artikel erstellt von Filter auf der Plattform, beschreibbar, registeredArticle.createdBy
registeredArticle_createdTime datetime Zeitpunkt der Erstellung des registrierten Artikels Filter auf der Plattform, beschreibbar, registeredArticle.createdTime
registeredArticle_documentId int64 ID des eingetragenen Artikels Filter auf der Plattform, beschreibbar, registeredArticle.documentId
registeredArticle_documentType varchar2 Registrierter Artikel – Dokumenttyp Filter auf der Plattform, beschreibbar, registeredArticle.documentType
registeredArticle_id guid ID des registrierten Artikels Filter auf der Plattform, beschreibbar, registeredArticle.id
registeredArticle_invoiceBasisId int64 ID der registrierten Rechnung auf Rechnungsbasis Filter auf der Plattform, beschreibbar, registeredArticle.invoiceBasisId
registeredArticle_invoiceText varchar2(1000) Text der Rechnung für einen registrierten Artikel Filter auf der Plattform, beschreibbar, registeredArticle.invoiceText
registeredArticle_nonInvoiceable char Registrierter Artikel, nicht abrechnungsfähig Filter auf der Plattform, beschreibbar, registeredArticle.nonInvoiceable
registeredArticle_note varchar2(1000) Hinweis zu registrierten Artikeln Filter auf der Plattform, beschreibbar, registeredArticle.note
registeredArticle_orderIndex int32 Index der registrierten Artikelbestellungen Filter auf der Plattform, beschreibbar, registeredArticle.orderIndex
registeredArticle_ownerId varchar2 ID des registrierten Artikelinhabers Filter auf der Plattform, beschreibbar, registeredArticle.ownerId
registeredArticle_ownerName varchar2 itgen_fnx_registeredarticle_ownername Filter auf der Plattform, beschreibbar, registeredArticle.ownerName
registeredArticle_timeLocked char Registrierter Artikel – zeitlich gesperrt Filter auf der Plattform, beschreibbar, registeredArticle.timeLocked
registeredArticle_totalQuantity decimal Gesamtmenge der registrierten Artikel Filter auf der Plattform, beschreibbar, registeredArticle.totalQuantity
registeredArticle_unitCost decimal Stückkosten für registrierte Artikel Filter auf der Plattform, beschreibbar, registeredArticle.unitCost
registeredArticle_unitPrice decimal Stückpreis des registrierten Artikels Filter auf der Plattform, beschreibbar, registeredArticle.unitPrice
registrationType varchar2 Anmeldetyp Filter auf der Plattform, beschreibbar, registrationType
version int64 Version Filter auf der Plattform, beschreibbar, version

Anmerkungen zu dieser Version

Was hat sich in den Tabellen, Spalten, Attributen und Funktionen des Treibers mit jeder neuen Version geändert: