API 2.1

CommunicationList

This method allows you to get a list of all documents that was communicated by the Tax Communication service to the Tax Authority. Here you can get a list with information about all documents that the service tried to communicate and the current status. You can choose the total of elements that you will receive and divide the response into pages and change the pages choosing the number of elements that will be inside a page.

POST https://bo.magnifinance.com/MagniAPI/taxcommunication.asmx

Sample Body


                            <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tax="http://MagniAPI/TaxCommunication/">
                            <soapenv:Header/>
                            <soapenv:Body>
                            <tax:CommunicationList>
                            <!--Optional:-->
                            <tax:authentication>
                            <!--Optional:-->
                            <tax:Email>{User}</tax:Email>
                            <!--Optional:-->
                            <tax:Token>{Token}</tax:Token>
                            </tax:authentication>
                            <!--Optional:-->
                            <tax:parameters>
                            <tax:TotalElements>100</tax:TotalElements>
                            <tax:ElementsPerPage>10</tax:ElementsPerPage>
                            <tax:CurrentPage>1</tax:CurrentPage>
                            </tax:parameters>
                            </tax:CommunicationList>
                            </soapenv:Body>
                            </soapenv:Envelope>

Request

Header

Parameter	Required	Value
Content-Type	required	text/xml

Body

Authentication

Parameter	Required	Description
Email	required	string(50) The API user email with specific permission to configure this service into the company.
Token	required	string(50) The token of the company that you are trying to active the Tax communication service.

Parameters

Parameter	Required	Description
TotalElements	optional	number The maximum number of documents that will be in the the returned list.Example value: "723"
ElementsPerPage	optional	number In the request you can send how much elements per page you want to list. The maximum value is "100". Example value: "10"
CurrentPage	optional	number The currentpage parameter is used to navigate between the total of pages in the list. Example value: "1"

Response

Parameter

Description

RequestId

Unique Id for the request to have a way to identify the request

Type

string Description to inform if the request was a success or error. Example value: "Success"

Object

Parameter

SortAscending	boolean The order that the list of documents will be in the response. This is "true" by default and represent that the list is order by old to new documents. Example value: "true"
TotalElements	number The total number of documents in the list and the total of documents that the service tried to submit to Tax Authority. Example value: "723"
ElementsPerPage	number In the request you can send how much elements per page you want to list. This will be returned in this parameter. Example value: "10"
CurrentPage	number The currentpage parameter is used to navigate between the total of pages in the list. Example value: "1"

TaxCommunication

TaxCommunicationBase

DocumentId	int The internal Id of the document. Example value: "67204"
FiscalDocumentNumber	string The document’s sequence number in the series. Example value: "FT FT/47"
Date	date The date of the document. Format: YYYY-MM-DD:T00:00:00. Example value: "2022-03-20:T00:00:00"
DocumentSubTypeId	string(1) The type of the document but represented by a single letter. Possible types are “T” for Invoice/Receipt, “I” for Invoice, “S” for Simplified Invoice, “C” for credit note and “D” for Debit Note. Example value:"I"
DocumentType	string The type of the document. Possible types are Invoice/Receipt, Invoice, Simplified Invoice , Credit Note and Debit Note. Example value:"Invoice"
FiscalDocumentStatusId	string(1) An FiscalDocumentStatusId return the status of the document but represented by a single letter. Possible types are "C" for Closed and "A" for Cancelled. Example value:"C"
FiscalDocumentStatus	string(1) An FiscalDocumentStatus is the status of the document. Possible types are Closed and Cancelled. Example value:"Closed"
IsPending	boolean Know if the document Is pending to be communicate or not. In case that are pending it is because our attempts of communication fail. In case of pending, the user should retry manually. Example value:"false"
IsSubmitted	boolean You can know if the document was successful submitted to the Tax Authority or not. Example value:"true"
CreatedOn	Data It is the date that the document was created in the platform. Example value:"2020-08-12T14:10:20.94"

ErrorValue

MagniEnum

Value	int Identifies the error with a number. To identify the types of errors in more detail. click here Example value: "1"
Name	string Identifies the error with a token. Example value: "AuthenticationError"

Example Response

Success


<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <CommunicationListResponse xmlns="http://MagniAPI/TaxCommunication/">
            <ResponseCommunicationList>
                <RequestId>2ec7e0ba-ce40-4a4c-a053-df081be53533</RequestId>
                <Type>Success</Type>
                <Object>
                    <Parameters>
                        <Initial>true</Initial>
                        <SortAscending>true</SortAscending>
                        <SearchString />
                        <TotalElements>834</TotalElements>
                        <ElementsPerPage>10</ElementsPerPage>
                        <CurrentPage>1</CurrentPage>
                    </Parameters>
                    <TaxCommunication>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>31824</FiscalDocumentId>
                            <FiscalDocumentNumber>FTM FTmu/23</FiscalDocumentNumber>
                            <Date>2020-10-16T00:00:00</Date>
                            <DocumentSubTypeId>I</DocumentSubTypeId>
                            <DocumentType>Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-12T14:10:20.94</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35455</FiscalDocumentId>
                            <FiscalDocumentNumber>NC TestNC/5</FiscalDocumentNumber>
                            <Date>2020-08-20T00:00:00</Date>
                            <DocumentSubTypeId>C</DocumentSubTypeId>
                            <DocumentType>Credit Note</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-24T17:57:09.25</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35463</FiscalDocumentId>
                            <FiscalDocumentNumber>FS FS/229</FiscalDocumentNumber>
                            <Date>2020-08-24T00:00:00</Date>
                            <DocumentSubTypeId>S</DocumentSubTypeId>
                            <DocumentType>Simplified Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-24T20:07:08.213</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35464</FiscalDocumentId>
                            <FiscalDocumentNumber>FTM FTmanual/22</FiscalDocumentNumber>
                            <Date>2020-08-24T00:00:00</Date>
                            <DocumentSubTypeId>I</DocumentSubTypeId>
                            <DocumentType>Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-25T11:32:25.043</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35470</FiscalDocumentId>
                            <FiscalDocumentNumber>FT FT/110</FiscalDocumentNumber>
                            <Date>2020-08-25T00:00:00</Date>
                            <DocumentSubTypeId>I</DocumentSubTypeId>
                            <DocumentType>Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-25T19:59:25.2</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35471</FiscalDocumentId>
                            <FiscalDocumentNumber>FT FT/111</FiscalDocumentNumber>
                            <Date>2020-08-25T00:00:00</Date>
                            <DocumentSubTypeId>I</DocumentSubTypeId>
                            <DocumentType>Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-25T20:01:21.57</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35472</FiscalDocumentId>
                            <FiscalDocumentNumber>FT ft3/24</FiscalDocumentNumber>
                            <Date>2020-08-25T00:00:00</Date>
                            <DocumentSubTypeId>I</DocumentSubTypeId>
                            <DocumentType>Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-25T20:02:21.127</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35473</FiscalDocumentId>
                            <FiscalDocumentNumber>FT FT/112</FiscalDocumentNumber>
                            <Date>2020-08-25T00:00:00</Date>
                            <DocumentSubTypeId>I</DocumentSubTypeId>
                            <DocumentType>Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-25T20:11:09.92</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35474</FiscalDocumentId>
                            <FiscalDocumentNumber>FT FT/113</FiscalDocumentNumber>
                            <Date>2020-08-25T00:00:00</Date>
                            <DocumentSubTypeId>I</DocumentSubTypeId>
                            <DocumentType>Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-25T20:12:06.29</CreatedOn>
                        </TaxCommunicationBase>
                        <TaxCommunicationBase>
                            <FiscalDocumentId>35476</FiscalDocumentId>
                            <FiscalDocumentNumber>FT FT/114</FiscalDocumentNumber>
                            <Date>2020-08-25T00:00:00</Date>
                            <DocumentSubTypeId>I</DocumentSubTypeId>
                            <DocumentType>Invoice</DocumentType>
                            <FiscalDocumentStatusId>C</FiscalDocumentStatusId>
                            <FiscalDocumentStatus>Closed</FiscalDocumentStatus>
                            <IsPending>true</IsPending>
                            <IsSubmitted>false</IsSubmitted>
                            <LastError />
                            <CreatedOn>2020-08-25T21:57:43.563</CreatedOn>
                        </TaxCommunicationBase>
                    </TaxCommunication>
                </Object>
            </ResponseCommunicationList>
        </CommunicationListResponse>
    </soap:Body>
</soap:Envelope>

Error


<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <ActivationSetResponse xmlns="http://MagniAPI/TaxCommunication/">
            <ResponseActivationSet>
                <RequestId>5165e271-97ec-4425-aa33-f7c32c7c6f3d</RequestId>
                <Type>Error</Type>
                <ErrorValue>
                    <Value>1</Value>
                    <Name>AuthenticationError</Name>
                </ErrorValue>
            </ResponseActivationSet>
        </ActivationSetResponse>
    </soap:Body>
</soap:Envelope>

REST API

SOAP API