המערכת שלנו משתמשת בקבוצה של מרחבי שמות XML שמיועדים לבנות ולזהות באופן ייחודי לחשבוניות, להערות אשראי, לבקשות למסמכים באצווה תשובות. מדריך זה מפרט את מרחבי השמות ואת השימוש הספציפי בהם פורמטים של מסמכים.
שימוש במרחב שמות בעיצוב המסמך
מסמכי ה-XML שלנו בנויים בהתאם לקבוצה מוגדרת של מרחבי שמות, הבטחת עקביות ותאימות עם תקן UBL 2.4 חשבוניות וחשבוניות אשראי. מרחבי השמות מאפשרים את ההבחנה בין קטעים שונים של המסמכים, כמו מפרטים של חשבוניות, זיכוי של ההערות ורכיבים נפוצים. בטבלה הבאה מפורטים מרחבי השמות בשימוש:
| תחילית | URI של מרחב שמות | תיאור |
|---|---|---|
inv |
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 |
משמש במיוחד לרכיבים של מסמכי חשבונית. |
cn |
urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2 |
חל על רכיבים במסמכי Credit Note. |
cac |
urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2 |
מייצג רכיבי צבירה נפוצים בסוגי מסמכים שונים. |
cbc |
urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2 |
מציין רכיבים בסיסיים שנמצאים בשימוש אוניברסלי במסמכי UBL. |
מרחבי שמות בקבוצות של מסמכים
לצורך צבירת מסמכים מרובים בבקשה באצווה אחת או
היא לא משתמשת באופן ספציפי במרחב השמות ext
ברמת אצווה. במקום זאת, מרחבי השמות הרגילים של UBL 2.4 משתמשים ישירות כדי
להבטיח עיבוד ברור וישיר של כל מסמך בתוך קבוצת המסמכים.
דוגמה להצהרת מרחב שמות בבקשה באצווה:
<RequestBatch xmlns:inv="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
xmlns:cn="urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2"
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2"
batchID="Batch-001"
documentCount="500">
...
</RequestBatch>