Document allows users to manage files associated with objects in Maximizer CRM.

A Document is a reference to identify a binary (file) previously loaded and stored in Maximizer CRM. See below some considerations for Document object:

Documents are associated to Maximizer objects (AbEntry, Opportunity, Case, etc) through the ParentKey property.
A special endpoint to load binaries has to be used. See examples in the HowTo's section for specific details.
When binaries are loaded, they are stored in a swap area. When a Document is created using the BinaryDataId (a.k.a. AttachmentId) reference, the default behavior is for the temporary file to be deleted from the swap area. It won't be available for further usage.
To override this behavior (and use the very same binary file for creating multiple Documents), the option "BinaryFileCleanup" needs to be specified when creating a document. See examples in the HowTo's section for specific details.

HowTo's

Create a document in Maximizer (Step 1 - Upload Binary)

// POST https://api.maximizer.com/octopus/BinaryUpload
// Authorization: Bearer <token>

Example: Response

// Request →
// POST https://api.maximizer.com/octopus/BinaryUpload
// Authorization: Bearer <token>

// Response ←
// When POST to BinaryUpload endpoint, the body provided must be the actual binary file.
// The binary file will be uploaded to a swap area and you are provided with a BinaryDataId identifier.
// You can use the BinaryDataId to reference this binary when creating the actual Document later on.
{
    "Code": 0,
    "BinaryData": {
        "Data": {
            "Size": 14493,
            "BinaryDataId": "429e276b-4e5f-44b0-ae37-064565eac287"
        }
    }
}

Create a document in Maximizer (Step 2 - Create document entry)

// POST https://api.maximizer.com/octopus/Create
// Authorization: Bearer <token>
{
    "Document": {
        "Data": {
            "Key": null,
            "Name": "Created Document From Postman",
            "Description": "This is an .xlsx document created from Postman",
            // At first, load the binary and use BinaryDataId returned here
            "BinaryDataId": "6bed8c90-d8e6-4f5e-8ab3-3afc3e5a44c7", // After File creation the binary won't be available to use anymore
            "Ext": ".xlsx", // Should be the same as binary data loaded
            // Type could be one of the following:
            // 1 = MaximizerDocuments, 
            // 3 = Emails, 
            // 7 = Others, 
            // 8 = LinkedDocuments, 
            // 12 = HyperlinkDocuments
            "Type": 1,
            // ParentKey can be OpportunityKey, AbEntryKey, LeadKey, CaseKey
            "ParentKey": "QWJFbnRyeQlERU1PXzFDCTA="
        }
    },
    "Configuration": {
        "Drivers": {
            "IDocumentAccess": "Maximizer.Model.Access.Sql.DocumentAccess"
        }
    }
}

Create a document in Maximizer (Step 2b - Create document entry and keep binary)

// POST https://api.maximizer.com/octopus/Create
// Authorization: Bearer <token>
{
    "Document": {
        "Data": {
            "Key": null,
            "Name": "Created Document From Postman",
            "Description": "This is an .xlsx document created from Postman",
            // At first, load the binary and use BinaryDataId returned here
            "BinaryDataId": "6bed8c90-d8e6-4f5e-8ab3-3afc3e5a44c7",
            "Ext": ".xlsx", // Should be the same as binary data loaded
            // Type could be one of the following:
            // 1 = MaximizerDocuments, 
            // 3 = Emails, 
            // 7 = Others, 
            // 8 = LinkedDocuments, 
            // 12 = HyperlinkDocuments
            "Type": 1,
            // ParentKey can be OpportunityKey, AbEntryKey, LeadKey, CaseKey
            "ParentKey": "QWJFbnRyeQlERU1PXzFDCTA="
        },
        "Options": {
            "BinaryFileCleanup": false // Use this option to keep the binary available for other Document creations
        }
    },
    "Configuration": {
        "Drivers": {
            "IDocumentAccess": "Maximizer.Model.Access.Sql.DocumentAccess"
        }
    }
}

Get documents that are email attachments

// POST https://api.maximizer.com/octopus/Read
// Authorization: Bearer <token>
{
    "Document": {
        "Scope": {
            "Fields": {
                "Key": 1,
                "Name": 1,
                "Description": 1,
                "Ext": 1,
                "Type": 1,
                "Size": 1,
                "ParentKey": 1,
                "Category": 1
            }
        },
        "Criteria": {
            "SearchQuery": {
                "$AND": [
                    {
                        "Key": {
                            "$EQ": "RG9jdW1lbnQJMTMxMDAwNjA0Nw==" // Interaction Key of Email
                        }
                    },
                    {
                        "Type": {
                            "$EQ": 3 // Type 3 = "Email"
                        }
                    }
                ]
            }
        },
        "Configuration": {
            "Drivers": {
                "IDocumentSearcher": "Maximizer.Model.Access.Sql.DocumentSearcher"
            }
        }
    }
}

Download Binary

// GET https://api.maximizer.com/octopus/BinaryDownload/document-key-here
// Authorization: Bearer <token>

Metadata

Read Document metadata (simple)

// POST https://api.maximizer.com/octopus/Read
// Authorization: Bearer <token>
{
    "Schema": {
        "Scope": {
            "Fields": 1
        },
        "Criteria": {
            "SearchQuery": {
                "Key": {
                    "$TREE": "/Document"
                }
            }
        }
    },
    "Compatibility": {
        "SchemaObject": "1.0"
    }
}

Read Document metadata (more)

// POST https://api.maximizer.com/octopus/Read
// Authorization: Bearer <token>
{
    "Schema": {
        "Scope": {
            "Fields": {
                "Key": 1,
                "Alias": 1,
                "Type": 1,
                "Name": 1,
                "AppliesTo": 1,
                "Sortable": 1,
                "Queryable": 1,
                "Mandatory": 1,
                "Attributes": 1,
                "DisplayValue": 1,
                "HasOption": 1
            }
        },
        "Criteria": {
            "SearchQuery": {
                "Key": {
                    "$TREE": "/Document"
                }
            }
        }
    },
    "Compatibility": {
        "SchemaObject": "1.0"
    }
}

FieldOptions

Read Document FieldOptions - Category

// POST https://api.maximizer.com/octopus/Read
// Authorization: Bearer <token>
{
    "Document": {
        "FieldOptions": {
            "Category": [
                {
                    "Key": 1,
                    "DisplayValue": 1
                }
            ]
        },
        "Data": {
            // Currently supported Entity Types:
            // 1 = AbEntry
            // 2 = Opportunity
            // 5 = Case
            "ParentKey": {
                "EntityType": 1
            }
        },
        "Compatibility": {
            "SchemaObject": "1.0"
        }
    }
}

Document CRUD

Create - Document

// POST https://api.maximizer.com/octopus/Create
// Authorization: Bearer <token>
{
    "Document": {
        "Data": {
            "Key": null,
            "Name": "Created Document From Postman",
            "Description": "This is an .xlsx document created from Postman",
            // At first, load the binary and use BinaryDataId returned here
            "BinaryDataId": "6bed8c90-d8e6-4f5e-8ab3-3afc3e5a44c7", // After File creation the binary won't be available to use anymore
            "Ext": ".xlsx", // Should be the same as binary data loaded
            // Type could be one of the following:
            // 1 = MaximizerDocuments, 
            // 3 = Emails, 
            // 7 = Others, 
            // 8 = LinkedDocuments, 
            // 12 = HyperlinkDocuments
            // Please check "FieldOptions" folder for details on how to retrieve the options for this field
            "Type": 1,
            // ParentKey can be OpportunityKey, AbEntryKey, LeadKey, CaseKey
            "ParentKey": "QWJFbnRyeQlERU1PXzFDCTA="
        }
    },
    "Configuration": {
        "Drivers": {
            "IDocumentAccess": "Maximizer.Model.Access.Sql.DocumentAccess"
        }
    }
}

Read - Document

// POST https://api.maximizer.com/octopus/Read
// Authorization: Bearer <token>
{
    "Document": {
        "Scope": {
            "Fields": {
                "Key": 1,
                "Name": 1,
                "Description": 1,
                "Ext": 1,
                "Type": 1,
                "Size": 1,
                "ParentKey": 1,
                "Category": 1
            }
        },
        "Criteria": {
            "SearchQuery": {},
            "Top": 3
        }
    },
    "Configuration": {
        "Drivers": {
            "IDocumentSearcher": "Maximizer.Model.Access.Sql.DocumentSearcher"
        }
    }
}

Delete - Document

// POST https://api.maximizer.com/octopus/Delete
// Authorization: Bearer <token>
{
    "Document": {
        "Data": {
            "Key": "RG9jdW1lbnQJMTUyMDE4NzE5OA=="
        }
    },
    "Configuration": {
        "Drivers": {
            "IDocumentAccess": "Maximizer.Model.Access.Sql.DocumentAccess"
        }
    }
}