Champ
Type
Description
externalId
Votre propre identifiant pour cette facture, provenant de votre logiciel. Envoyez à nouveau le même externalId pour mettre à jour cette facture au lieu d'en ajouter une nouvelle. Nous faisons la correspondance sur cette valeur, mais nous n'empêchons pas les doublons; gardez-la donc unique au sein du site.
invoiceNumber
Le numéro attribué par le système source et affiché au client sur la Facture. Deux Factures d'un même site peuvent partager un numéro, et un paiement appliqué par numéro est attribué à la première correspondance trouvée; gardez-le donc unique au sein du site.
totals
Les montants totaux de Facture. Lorsque lines est fourni, total est validé par rapport à celles-ci et doit être égal à la somme de chaque lines[].total, plus taxes, moins discounts. Une requête dont les totaux ne concordent pas est rejetée. Omettez lines et aucune vérification de ce type n'est effectuée.
customer
Une référence au dossier du client.
invoiceTermName
Le nom d'une condition de facture configurée pour le site, par exemple Net 30. Lorsqu'il est envoyé, la date d'échéance est calculée à partir de la condition et de la date de la Facture, remplaçant tout dueDate que vous envoyez. Un nom ne correspondant à aucune condition est rejeté avec Invoice term "" not found. Lorsqu'il est omis pour une nouvelle Facture, la condition de facture du client est utilisée s'il en a une.
lines
Une liste des articles de ligne sur le Facture. Requis si description n'est pas passé en.
description
Une brève description des produits/services sur le Facture. Requis si les lines ne sont pas passées en paramètre.
invoiceDate
La date de Facture. Si elle est fixée dans le futur, Facture n'est envoyé par texto ou par courriel au client qu'à cette date. Par défaut, la date du jour si elle est laissée vide. Une date sans heure. Une heure ou un fuseau horaire envoyé avec elle est ignoré, et non converti, de sorte que la date reste telle qu'écrite. Format = YYYY-MM-DD
customerMemo
Une note présentée au client en bas du Facture.
internalMemo
Un mémo ajouté au bas de la Facture. Visible uniquement par le personnel interne, jamais affiché aux clients.
payments
Une liste des paiements effectués sur le Facture.
webhookUrl
L'URL à laquelle envoyer une requête POST lorsque certaines actions sont effectuées sur Facture. Un webhook est envoyé lorsqu'un paiement atteint un nouvel état, et lorsqu'un message texte, un courriel ou un message WhatsApp est envoyé, livré, lu, retardé ou échoue, ou lorsque le client clique sur le lien de paiement.
options
Options à définir sur le Facture.
attachmentRefs
Une liste de pièces jointes.
send
À qui Facture est envoyé, par canal. Un canal que vous indiquez est utilisé tel quel, et une liste vide ([]) désactive ce canal. Un canal que vous omettez conserve les destinataires que Facture a déjà, ou est rempli à partir des contacts du client, selon le contrôle des notifications du client, lorsqu'il n'en a pas encore. Lors d'une création, omettez send pour laisser les contacts du client décider de chaque canal lors de l'envoi de Facture. Lors d'une mise à jour, l'omettre conserve les destinataires déjà choisis. Une lecture renvoie send.to à null tant que les destinataires n'ont pas été choisis. billTo.emails et billTo.sms demeurent le remplacement pour déterminer qui reçoit ces canaux, mais ne réactivent jamais un canal que send a désactivé.
onHold
Indique si le premier versement impayé est mis en attente, de sorte que sa demande de paiement n'est pas envoyée tant que la mise en attente n'est pas levée. En lecture, la valeur est true lorsque ce versement est en attente et false autrement. En écriture, définissez-la à true pour mettre ce versement en attente, ou à false lors d'une mise à jour pour la lever. Omettez-la pour laisser la mise en attente telle quelle. La mise en attente se trouve sur le versement, et non sur Facture.
false lève une mise en attente que vous ou le marchand avez placée. Il ne lève pas la mise en attente qu'obtient Facture lorsqu'il ne rejoint personne et ne sera pas facturé automatiquement : send.to désactive tous les canaux, ou toutes les adresses du client sont en mode ne pas contacter et il n'y a aucun remplacement billTo. Ce Facture reste en attente et l'écriture réussit quand même, y compris lorsque vous fournissez vous-même installments ou définissez installments[].onHold à false. Donnez-lui un destinataire pour permettre l'envoi.
Une écriture qui envoie à la fois onHold et installments[].onHold sur le premier versement impayé doit leur donner la même valeur. Sinon, elle est refusée avec une erreur 400 et le message « Invalid on_hold, it conflicts with on_hold on the first unpaid installment. Send one of them, or the same value in both ». Une valeur qui n'est pas un booléen est refusée avec « Invalid on_hold, must be a boolean ».
deleted
Ce drapeau représente si l'enregistrement est supprimé et n'est plus disponible pour être utilisé.