Envio de Recibos por email

Envio de email de recibos via API. Inclui instruções de uso, headers e um exemplo de JSON payload para definição de emails e conteúdo.

Envio de Documentos por email

Envio de Documentos por email

patch

/api/email/document

Authorizations

Body

dataobject

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '{{base_url}}/api/email/document' \
  --header 'Content-Type: application/json' \
  --data '{
    "data": {
      "attributes": {
        "from_email": "[e-mail]",
        "from_name": "Nome do remetente",
        "subject": "Assunto da mensagem",
        "to_email": "[e-mail]",
        "type": "Document"
      },
      "id": 3,
      "type": "email/document"
    }
  }'

200

200

No body

curl -v -X POST -H 'Content-Type: application/vnd.api+json' -H 'Accept: application/json' -H 'Authorization: Bearer <access_token>' -d '<payload JSON>' '<API_URL>/email/document/<id do documento ou recibo>'

No pedido acima, o access_token é o token de acesso válido devolvido pelo serviço de OAuth e o id do documento ou recibo é o "id" interno do documento ou do recibo (cabeçalho), o devolvido no campo "id" da resposta ao seu pedido de criação. O payload JSON a enviar contém a seguinte informação:

Payload

{
  "data": {
    "type": "email/document",                                  // [OBRIGATÓRIO]
    "id": "<id do documento ou do recibo>",                    // [OBRIGATÓRIO] Este "id" é o devolvido na resposta ao pedido de criação do cabeçalho do documento ou do recibo, ver acima
    "attributes": {
      "type": "Receipt",                                       // [OBRIGATÓRIO "Receipt" para recibos
      "to_email": "[e-mail]",           // [OPCIONAL] Por omissão é o endereço de email do cliente; se não existir tem que ser indicado. Podem ser vários, separados por ,
      "from_email": "[e-mail]",            // [OPCIONAL] Por omissão é o endereço no-reply de email do sistema (TOConline, Business...)
      "from_name": "Nome do remetente",                        // [OPCIONAL]
      "subject": "Assunto da mensagem"                         // [OPCIONAL] Por omissão é o assunto padrão do sistema ("(Nome da empresa) enviou-lhe um documento/recibo através do (TOConline, Business...)")
    }
  }
}

Exemplo de Response

{
    "success": true,
    "to_addresses": "[e-mail]"
}