Ejemplos de llamadas

Consultar si existe un cliente por NIF o por código de cliente

Obtener un cliente existente por NIF o código fiscal

curl -u [API_TOKEN]:x https://[ACCOUNT_NAME].facturadirecta.com/api/clients.xml?taxCode=[TAXCODE]

Obtener un cliente existente por código de cliente

curl -u [API_TOKEN]:x https://[ACCOUNT_NAME].facturadirecta.com/api/clients.xml?code=[CLIENT_CODE]

Respuesta

<clients>
    <client>
 <id>23</id>
    </client>
    ...
</clients>

Más info: GET /api/clients.xml

Crear un nuevo cliente

Ejemplo de creación de un nuevo cliente

curl -u [API_TOKEN]:x -X POST -H 'Accept: application/xml' -H 'Content-Type: application/xml'
-d "<?xml version='1.0' encoding='UTF-8'?>
<client>
        <name><![CDATA[Nombre Cliente]]></name>
        <taxCode><![CDATA[NIF o Código fiscal]]></taxCode>
        <address>
                <line1><![CDATA[primera linea de dirección]]></line1>
                <line2><![CDATA[segunda linea de dirección]]></line2>
                <city><![CDATA[Vic]]></city>
                <province><![CDATA[Barcelona]]></province>
                <zipcode><![CDATA[08028]]></zipcode>
                <country><![CDATA[ES]]></country>
        </address>
        <website><![CDATA[]]></website>
        <email><![CDATA[]]></email>
        <phone><![CDATA[]]></phone>
        <mobilePhone><![CDATA[]]></mobilePhone>
        <notes><![CDATA[]]></notes>
        <companyCode><![CDATA[Código de cliente]]></companyCode>
</client>"
https://[ACCOUNT_NAME].facturadirecta.com/api/clients.xml

Respuesta

<client>
 <id>ID GENERADO POR LA APLICACIÓN</id>
 ...
</client>

Más info: POST /api/clients.xml

Crear una factura

Ejemplo de creación de una factura (pagada) con los datos mínimos

curl -u [API_TOKEN]:x -X POST -H 'Accept: application/xml' -H 'Content-Type: application/xml'
-d "<?xml version='1.0' encoding='UTF-8'?>
<invoice>
        <client>
                <id>1</id>
        </client>
 <invoiceDate>20130729</invoiceDate>
        <currency>EUR</currency>
        <subject>transaction_id:1203941203948</subject>
        <tax1>
                <name>IVA</name>
                <rate>21.00</rate>
        </tax1>
        <invoiceLines>
                <invoiceLine>
                        <productCode><![CDATA[T2]]></productCode>
                        <description><![CDATA[Servicio de transporte]]></description>
                        <quantity>3.00</quantity>
                        <unitPrice>25.00</unitPrice>
                </invoiceLine>
        </invoiceLines>
        <payments>
                <payment>
                        <paymentDate>20130729</paymentDate>
                </payment>
        </payments>
</invoice>
"
https://[ACCOUNT_NAME].facturadirecta.com/api/invoices.xml

RESPUESTA

<invoice>
 <id>ID GENERADO POR LA APLICACIÓN</id>
 ...
</invoice>

Más info: POST /api/invoices.xml