Trimitere Document prin Email

Trimite o factura sau o proforma catre client, pe email, ca atasament.

Cerinte: trebuie sa ai configurat serverul de email in SmartBill Cloud > Configurare > Email.

Variabile pentru textul emailului: Parametrul bodyText accepta urmatorii marcatori:

• #tip document# - tipul documentului (factura/proforma)
• #serie numar document# - seria si numarul
• #link document# - link catre document
• #data emiterii# - data emiterii
• #data scadentei# - data scadentei
• #total document# - suma totala, cu moneda
• #mentiune# - mentiunile documentului
• #nume client# - numele clientului
• #persoana contact# - persoana de contact

Nota: atat subject, cat si bodyText trebuie codificate Base64.

Ce e obligatoriu si ce are fallback

Obligatorii sunt doar companyVatCode, seriesName, number si type. Restul au fallback:

• to omis sau gol - emailul se trimite la adresa clientului de pe document;
• subject sau bodyText omise - se foloseste sablonul configurat in contul SmartBill.

Valoarea din type nu e sensibila la litere mari: factura, Factura si FACTURA sunt acceptate la fel. type selecteaza si tipul de document cautat - o proforma trimisa cu type: factura intoarce Documentul nu a fost gasit.

Forma raspunsului

Endpointul nu raspunde ca restul V1. Raspunsul are un obiect status, cu code si message:

{ "status": { "code": 0, "message": "Documentul a fost trimis cu succes." } }

code este 0 la succes si 1 la eroare. Nu exista camp errorText - un client care verifica doar errorText nu vede niciodata eroarea. Excepția: erorile de autentificare si de acces la firma vin in forma clasica V1, cu errorText, si cu status HTTP 401.

Ai primit o eroare la trimiterea emailului?

Erorile de autentificare si autorizare sunt comune tuturor endpoint-urilor V1. Pentru email/token, companyVatCode, drepturi pe firma, vezi Erori API V1. Mai jos gasesti doar erorile specifice acestui endpoint. Toate vin cu status.code: 1.

<details> <summary><strong>Erori la trimiterea emailului</strong></summary> <table> <thead> <tr> <th>Situatie</th> <th>Eroare</th> <th>Sugestie</th> </tr> </thead> <tbody> <tr> <td>Valoare neacceptata in <code>type</code></td> <td><code>Valoarea campului 'type' nu este suportata (invoice). Valorile acceptate sunt: factura, proforma.</code></td> <td>Trimite `factura` sau `proforma`. Variantele englezesti `invoice` si `estimate` nu sunt acceptate. Litera mare nu conteaza.</td> </tr> <tr> <td><code>type</code> lipsa sau gol</td> <td><code>type trebuie specificat. Valorile acceptate sunt: factura, proforma.</code></td> <td>`type` e obligatoriu, spre deosebire de `to`, `subject` si `bodyText`.</td> </tr> <tr> <td>Documentul nu exista, sau <code>type</code> nu corespunde tipului lui</td> <td><code>Documentul nu a fost gasit</code></td> <td>Verifica `seriesName` si `number`. Apare si cand documentul exista, dar e trimis cu tipul greșit - o proforma cu `type: factura`, de exemplu.</td> </tr> <tr> <td><code>seriesName</code> gol</td> <td><code>Seria nu a fost gasita! Folositi o serie creata in contul de cloud.</code></td> <td>Trimite o serie existenta in contul SmartBill Cloud.</td> </tr> <tr> <td><code>number</code> gol</td> <td><code>Numarul documentului trebuie specificat</code></td> <td>Trimite numarul documentului, ca text.</td> </tr> <tr> <td><code>subject</code> nu e codificat Base64</td> <td><code>Subiectul emailului trebuie sa fie codat folosind Base64.</code></td> <td>Codifica subiectul in Base64 inainte de trimitere.</td> </tr> <tr> <td><code>bodyText</code> nu e codificat Base64</td> <td><code>Continutul emailului trebuie sa fie codat folosind Base64.</code></td> <td>Codifica si corpul emailului in Base64.</td> </tr> <tr> <td>Adresa de email invalida, in <code>to</code>, <code>cc</code> sau <code>bcc</code></td> <td><code>Invalid Addresses</code>, <code>Missing domain</code>, <code>Missing local name</code>, <code>Domain contains illegal character</code></td> <td>Mesajul depinde de felul in care e ruptă adresa. La mai multi destinatari, una singura invalida respinge tot apelul.</td> </tr> <tr> <td>Serverul de email nu e configurat in cont</td> <td><code>Server-ul de email nu a fost configurat.</code></td> <td>Configureaza serverul de email in [SmartBill Cloud > Configurare > Email](https://cloud.smartbill.ro/core/configurare_mailuri/).</td> </tr> </tbody> </table> </details>