more docs

models/reporting/xero/schema.yaml

@@ -256,7 +256,7 @@ models:
 
       - name: invoice_currency_iso_4217
         data_type: character varying
-        description: | 
+        description: |
           The currency in which this line item amounts are defined.
 
           Line items don't really have a currency definition of its own, this 
@@ -268,3 +268,181 @@ models:
       - name: line_description
         data_type: text
         description: A text description of the line item.
+  - name: xero__contacts
+    description: |
+      Xero contacts identify other parties we transact with: customers, suppliers, employees, etc. 
+
+      The most interesting contacts are our customers.
+    columns:
+      - name: id_contact
+        data_type: character varying
+        description: Xero's unique identifier for the contact.
+
+      - name: account_number
+        data_type: character varying
+        description: A Superhog set identifier. For customers, this is Hubspot's Deal Id.
+
+      - name: id_deal
+        data_type: text
+        description: | 
+          For those account numbers that look like a Deal Id, we extract them 
+          into this field. Other contacs will have a blank.
+
+          You can use this to find specific deal ids or even as a proxy bool to
+          keep or remove deal id customers.
+
+
+      - name: contact_name
+        data_type: character varying
+        description: The name for the customer.
+
+      - name: is_customer
+        data_type: boolean
+        description: Flag that shows if the contact is a Superhog customer.
+
+      - name: is_supplier
+        data_type: boolean
+        description: Flag that shows if the contact is a Superhog supplier.
+
+      - name: tax_number
+        data_type: character varying
+        description: Tax number for this contact.
+
+      - name: contact_first_name
+        data_type: character varying
+        description: ""
+
+      - name: contact_last_name
+        data_type: character varying
+        description: ""
+
+      - name: phones
+        data_type: jsonb
+        description: ""
+
+      - name: website
+        data_type: character varying
+        description: ""
+
+      - name: balances
+        data_type: jsonb
+        description: ""
+
+      - name: discount
+        data_type: numeric
+        description: ""
+
+      - name: addresses
+        data_type: jsonb
+        description: ""
+
+      - name: attachments
+        data_type: jsonb
+        description: ""
+
+      - name: email_addresses
+        data_type: character varying
+        description: ""
+
+      - name: payment_terms
+        data_type: jsonb
+        description: ""
+
+      - name: batch_payments
+        data_type: jsonb
+        description: ""
+
+      - name: branding_theme
+        data_type: jsonb
+        description: ""
+
+      - name: contact_groups
+        data_type: jsonb
+        description: ""
+
+      - name: contact_number
+        data_type: character varying
+        description: ""
+
+      - name: contact_status
+        data_type: character varying
+        description: ""
+
+      - name: skyper_user_name
+        data_type: character varying
+        description: ""
+
+      - name: contact_persons
+        data_type: jsonb
+        description: ""
+
+      - name: has_attachments
+        data_type: boolean
+        description: ""
+
+      - name: updated_at_utc
+        data_type: timestamp with time zone
+        description: ""
+
+      - name: updated_date_utc
+        data_type: date
+        description: ""
+
+      - name: xero_network_key
+        data_type: character varying
+        description: ""
+
+      - name: default_currency_iso_4217
+        data_type: character varying
+        description: |
+          The default currency used to interact with this contact. 
+          
+          For customers, this is the currency we will usually use to invoice.
+
+      - name: validation_errors
+        data_type: jsonb
+        description: ""
+
+      - name: bank_account_details
+        data_type: character varying
+        description: ""
+
+      - name: has_validation_errors
+        data_type: boolean
+        description: ""
+
+      - name: tracking_category_name
+        data_type: character varying
+        description: ""
+
+      - name: account_payable_tax_type
+        data_type: character varying
+        description: ""
+
+      - name: tracking_category_option
+        data_type: character varying
+        description: ""
+
+      - name: sales_default_account_code
+        data_type: character varying
+        description: ""
+
+      - name: sales_tracking_categories
+        data_type: jsonb
+        description: ""
+
+      - name: account_receivable_tax_type
+        data_type: character varying
+        description: ""
+
+      - name: purchases_default_account_code
+        data_type: character varying
+        description: ""
+
+      - name: purchases_tracking_categories
+        data_type: jsonb
+        description: ""
+
+      - name: dwh_extracted_at_utc
+        data_type: timestamp with time zone
+        description: ""