invantive documentation
Forum di supporto InvantiveAccedi / Registrati

SalesInvoices: Robaws Fatture di vendita

insert update delete REST

  • Catalogo: Robaws
  • Schema: SalesInvoices
  • Chiavi primarie: id
  • Etichetta: Fatture di vendita

Cerca

È possibile recuperare e modificare i dati utilizzando insert, update e delete.

Codice sorgente dell'API

  • Punto finale: /api/v2/sales-invoices
  • Operazione: get /api/v2/sales-invoices

Caratteristiche prestazionali

Characteristic Value
Latenza media di accesso (ms) 134
Righe di scansione completa al minuto 26,819
Numero di righe di Query al minuto 933
Scrittura di righe al minuto 539

Il risultato può essere memorizzato nella memoria cache sul client.

Parametri

Name Tipo di dati Required Default Documentation
articleId ``
clientId ``
deliveryNoteId ``
fromDate ``
journalId ``
journalName ``
materialId ``
projectId ``
salesOrderId ``
searchText ``
sort ``
subscriptionId ``
toDate ``
type `` Valori: INVOICE, CREDIT_NOTE.
updatedFrom ``
withArchived ``
workOrderId ``

Colonne della tabella

Di seguito sono riportate le colonne della tabella SalesInvoices. Ogni colonna ha un tipo di dati SQL. Un nuovo valore non nullo deve essere fornito per ogni colonna richiesta in ogni momento durante l'inserimento e l'aggiornamento.

Name Tipo di dati Label Required Marks Documentation
accountancyStatus varchar2 Stato della contabilità filtri sulla piattaforma, modificabili, accountancyStatus
advanceInvoice char Fattura anticipata filtri sulla piattaforma, modificabili, advanceInvoice
advancePercentage decimal Avanzamento (%) filtri sulla piattaforma, modificabili, advancePercentage La percentuale di acconto, espressa su una scala da 0 a 100.
archivedAt datetime Archiviato in filtri sulla piattaforma, modificabili, archivedAt
assignedUserId varchar2 ID utente assegnato filtri sulla piattaforma, modificabili, assignedUserId
booked char Booked filtri sulla piattaforma, modificabili, booked
clientId varchar2 ID del cliente filtri sulla piattaforma, modificabili, clientId
clientReference varchar2 Referenza del cliente filtri sulla piattaforma, modificabili, clientReference
companyId varchar2 ID dell'azienda filtri sulla piattaforma, modificabili, companyId
contactPersonId varchar2 ID persona di contatto filtri sulla piattaforma, modificabili, contactPersonId
createdAt datetime Creato il filtri sulla piattaforma, modificabili, createdAt
creditedInvoiceId varchar2 ID della fattura accreditata filtri sulla piattaforma, modificabili, creditedInvoiceId Presente solo per le fatture di tipo CREDIT_NOTE.È l'id della fattura stornata da questa nota di credito.
creditedTotal decimal Totale accreditato filtri sulla piattaforma, modificabili, creditedTotal Presente solo per le fatture di tipo INVOICE
currency varchar2 Currency filtri sulla piattaforma, modificabili, currency
date datetime Date filtri sulla piattaforma, modificabili, date
deletedAt datetime Eliminato alle filtri sulla piattaforma, modificabili, deletedAt
deliveryClientId varchar2 Client ID per la consegna filtri sulla piattaforma, modificabili, deliveryClientId
deliveryNoteId varchar2 ID della bolla di consegna filtri sulla piattaforma, modificabili, deliveryNoteId
documentId varchar2 ID del documento filtri sulla piattaforma, modificabili, documentId
exchangeRate decimal Tasso di cambio filtri sulla piattaforma, modificabili, exchangeRate
expireDate datetime Data di scadenza filtri sulla piattaforma, modificabili, expireDate
extraFields varchar2 Campi aggiuntivi writable Il testo JSON dell'oggetto annidato.
finalInvoice char Fattura finale filtri sulla piattaforma, modificabili, finalInvoice
holdbackItem_calculatedAmount decimal Voce di trattenuta – Importo calcolato filtri sulla piattaforma, modificabili, holdbackItem.calculatedAmount
holdbackItem_deadline datetime Scadenza per la voce soggetta a trattenuta filtri sulla piattaforma, modificabili, holdbackItem.deadline
holdbackItem_fixedAmount decimal Voce di trattenuta – Importo fisso filtri sulla piattaforma, modificabili, holdbackItem.fixedAmount
holdbackItem_numberOfDays int32 Ritenuta - Numero di giorni filtri sulla piattaforma, modificabili, holdbackItem.numberOfDays
holdbackItem_percentage decimal Percentuale di trattenuta per voce filtri sulla piattaforma, modificabili, holdbackItem.percentage
holdbackItem_type varchar2 Tipo di voce di trattenuta filtri sulla piattaforma, modificabili, holdbackItem.type
id varchar2 ID filtri sulla piattaforma, modificabili, id
introText varchar2 Testo introduttivo filtri sulla piattaforma, modificabili, introText In lettura, presente solo se richiesto tramite il parametro di query 'include', altrimenti null.Contenuto HTML.Le immagini incorporate vengono risolte in URL in base all'intestazione della richiesta 'x-robaws-html-image-mode': TEMPORARY_URL (predefinito) restituisce URL prefirmati a tempo limitato che non richiedono autenticazione; PERMANENT_URL restituisce URL stabili che richiedono una sessione autenticata; NONE restituisce l'HTML memorizzato, in cui ogni immagine è un con un data-robaws-id e un src vuoto: mantenere questo tag e il suo data-robaws-id quando si riscrive l'HTML, altrimenti l'immagine viene persa.Qualsiasi altro valore (ad es.BASE64_INLINE) restituisce 400 Bad Request.In scrittura, ometterlo o inviare null per mantenere il testo attuale; inviare una stringa vuota per cancellarlo.
invoicePeriod_end datetime Fine del periodo di fatturazione filtri sulla piattaforma, modificabili, invoicePeriod.end
invoicePeriod_start datetime Inizio del periodo di fatturazione filtri sulla piattaforma, modificabili, invoicePeriod.start
journalId varchar2 ID articolo filtri sulla piattaforma, modificabili, journalId
journalName varchar2 Nome della rivista filtri sulla piattaforma, modificabili, journalName Obsoleto.Per creare le fatture usare invece companyId e journalId.
lockedAt datetime Bloccato su filtri sulla piattaforma, modificabili, lockedAt
logicId varchar2 ID logico filtri sulla piattaforma, modificabili, logicId
openTotal decimal Totale aperto filtri sulla piattaforma, modificabili, openTotal
originType varchar2 Tipo di origine filtri sulla piattaforma, modificabili, originType
paidTotal decimal Totale pagato filtri sulla piattaforma, modificabili, paidTotal
paymentConditionId varchar2 ID delle condizioni di pagamento filtri sulla piattaforma, modificabili, paymentConditionId
paymentInstruction varchar2 Istruzioni di pagamento filtri sulla piattaforma, modificabili, paymentInstruction
peppolResponseStatus varchar2 Stato della risposta Peppol filtri sulla piattaforma, modificabili, peppolResponseStatus
peppolSentDate datetime Data di invio di Peppol filtri sulla piattaforma, modificabili, peppolSentDate
peppolStatus varchar2 Stato Peppol filtri sulla piattaforma, modificabili, peppolStatus
poNumber varchar2 Numero d'ordine filtri sulla piattaforma, modificabili, poNumber
rechnungType varchar2 Tipo di fattura tedesca filtri sulla piattaforma, modificabili, rechnungType
remark varchar2 Remark filtri sulla piattaforma, modificabili, remark
rentalInvoicingPeriodId varchar2 ID del periodo di fatturazione del noleggio filtri sulla piattaforma, modificabili, rentalInvoicingPeriodId
selfBilling char Autofatturazione filtri sulla piattaforma, modificabili, selfBilling
selfBillingNumber varchar2 Numero di autofatturazione filtri sulla piattaforma, modificabili, selfBillingNumber
status varchar2 Status filtri sulla piattaforma, modificabili, status
statusDetails_color varchar2 Dettagli stato Colore filtri sulla piattaforma, modificabili, statusDetails.color
statusDetails_name varchar2 Stato Dettagli Nome filtri sulla piattaforma, modificabili, statusDetails.name
subscriptionId varchar2 ID dell'abbonamento filtri sulla piattaforma, modificabili, subscriptionId
totalExclVat decimal Totale IVA esclusa filtri sulla piattaforma, modificabili, totalExclVat Totale delle righe al netto dell'IVA, nella valuta del documento (attributes.currency); il tasso di cambio non viene applicato.In /aggregate, SUM, AVG, MIN e MAX considerano negativa una nota di credito; /query restituisce il valore così come memorizzato.
totalInclVat decimal Totale IVA inclusa filtri sulla piattaforma, modificabili, totalInclVat Totale IVA inclusa, nella valuta del documento (attributes.currency); il tasso di cambio non viene applicato.In /aggregate, SUM, AVG, MIN e MAX considerano negativa una nota di credito; /query restituisce il valore così come memorizzato.
type varchar2 Type filtri sulla piattaforma, modificabili, type
updatedAt datetime Aggiornato il filtri sulla piattaforma, modificabili, updatedAt
withRespectTo varchar2 In merito a filtri sulla piattaforma, modificabili, withRespectTo

Chiavi

Key Column Si riferisce a Kind Description
SalesInvoices_assignedUserId_txt assignedUserId Users.id Textual La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento.
SalesInvoices_clientId_txt clientId Clients.id Textual La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento.
SalesInvoices_companyId_fk companyId Companies.id Key
SalesInvoices_creditedInvoiceId_txt creditedInvoiceId SalesInvoices.id Textual La riga di riferimento, finché Robaws continua a elencarla: una riga eliminata o purgata non è più elencata, ma un documento può continuare a farvi riferimento.
SalesInvoices_deliveryNoteId_fk deliveryNoteId DeliveryNotes.id Key
SalesInvoices_subscriptionId_fk subscriptionId Subscriptions.id Key

Riferito da

Esempi di Query

select inv.logicId
,      inv.date
,      inv.expireDate
,      inv.openTotal
,      cnt.name client_name
from   Robaws.SalesInvoices.SalesInvoices inv
join   Robaws.Clients.Clients cnt
on     cnt.id = inv.clientId
where  inv.openTotal > 0

Note di rilascio

Cosa è cambiato, versione per versione, nelle tabelle, nelle colonne, negli attributi e nelle funzionalità del driver: