ה-API של כספית עובד כך:
אתה שולח לו נתונים של הישות (מסמך, לקוח) ואופציונאלית גם את המפתח שאתה רוצה להשתמש בו בכדי לשלוף את הישות שנוצרה'.

לכן ישנן שתי אפשרויות:

אם אתה רוצה שכספית תייצר מפתח עבורך –
השאר את השדה NULL. כספית תייצר מפתח שהוא GUID, לדוגמה: f3a6f8e6-1933-48ca-af1d-8c4aaa033545
אם אתה רוצה לעדכן את המסמך בעתיד, אז שמור את המפתח שתקבל בתשובה של כספית.

אם אתה רוצה להשתמש במפתח שלך (לדוגמה, מפתח ממערכת קיימת שבה ישנם הנתונים של המכירה) – שלח אותו בשדה.
המפתח חייב להיות יחודי. אם תשלח חשבונית חדשה עם מפתח של חשבונית שכבר קיימת אז כספית תעדכן את החשבונית הקיימת (ולא תיצור חדשה).