POST/Contrato

curl -X POST 'https://bling.com.br/Api/v2/contrato'
     -d "apikey={apikey}"
     -d "xml={xml_do_contrato}"

Através deste método é possível inserir um contrato no sistema. Os campos disponíveis para envio estão listados na tabela a seguir. A explicação dos códigos contidos na coluna "nota" deve ser consultada na tabela de notas.

Para visualizar um exemplo de XML para o método POST clique no botão abaixo.

<?xml version="1.0" encoding="UTF-8"?>
<contrato>
   <anoFimDesconto>2018</anoFimDesconto>
   <anoTermino>2025</anoTermino>
   <contatoDiferenteCobranca>0</contatoDiferenteCobranca>
   <dataBase>29/08/2019</dataBase>
   <dataCriacao>28/08/2019</dataCriacao>
   <desconto>1</desconto>
   <descricao>API POST TESTE</descricao>
   <diaVencimento>5</diaVencimento>
   <emiteNota>S</emiteNota>
   <emiteOS>S</emiteOS>
   <idCategoria>614413</idCategoria>
   <idPortador>795094295</idPortador>
   <idVendedor>49585900</idVendedor>
   <mesFimDesconto>10</mesFimDesconto>
   <mesTermino>12</mesTermino>
   <mesVencimento>C</mesVencimento>
   <nroParcelasVendedor>5</nroParcelasVendedor>
   <numeroContrato>777</numeroContrato>
   <obs>Observação interna do contrato, esta informação não será impressa</obs>
   <opcoesNota>
     <CFOP>77390</CFOP>
     <codListaServico>0101</codListaServico>
     <descIRTotalNota>S</descIRTotalNota>
     <descISSTotalNota>N</descISSTotalNota>
     <idProdutoVinculado>49002612</idProdutoVinculado>
     <mesNota>C</mesNota>
     <naturezaOperacao>Aluguel de outras maquinas e equipamentos comerciais</naturezaOperacao>
     <percentualISS>11</percentualISS>
     <textoNota>Observações da NF-e / Descrição do serviço da NFS-e</textoNota>
   </opcoesNota>
   <percentualVendedor>0.4</percentualVendedor>
   <periodicidadeCobranca>1</periodicidadeCobranca>
   <situacao>A</situacao>
   <valor>105.95</valor>
   <cliente>
     <nome>JOHN WICK</nome>
     <cnpj_cpf>45384138017</cnpj_cpf>
     <tipo>F</tipo>
     <bairro>BENVENUTTI</bairro>
   </cliente>
   <anexos>
     <anexo>
         <filename>teste.txt</filename>
         <data>QVJRVUlWTyBERSBURVNURSwgVVBMT0FEIERFIEFSUVVJVk8gQkFTRTY1NEVOQ09ERUQgVklBIFhNTCBBUEkK</data>
     </anexo>
     <anexo>
         <filename>imagemteste.jpg</filename>
         <data>/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDADUlKC8oITUvKy88OTU/UIVXUElJUKN1e2GFwarLyL6qurfV8P//1eL/5re6////////////zv//////////////2wBDATk8PFBGUJ1XV53/3Lrc////////////////////////////////////////////////////////////////////wAARCAAKAA0DASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwBDNag9GP0p322EdFb8BWfRT+rw63Juf//Z</data>
      </anexo>
      </anexos>
</contrato>

Exemplo de requisição utilizando a linguagem PHP.

$url = 'https://bling.com.br/Api/v2/contrato/';
$xml = '<?xml version="1.0" encoding="UTF-8"?><contrato>...</contrato>';
$posts = array (
   "apikey" => "{apikey}",
   "xml" => rawurlencode($xml)
);
$retorno = executeInsertContract($url, $posts);
echo $retorno;
function executeInsertContract($url, $data){
   $curl_handle = curl_init();
   curl_setopt($curl_handle, CURLOPT_URL, $url);
   curl_setopt($curl_handle, CURLOPT_POST, count($data));
   curl_setopt($curl_handle, CURLOPT_POSTFIELDS, $data);
   curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, TRUE);
   $response = curl_exec($curl_handle);
   curl_close($curl_handle);
   return $response;
}

Caso a requisição seja concluída com sucesso você receberá um retorno conforme abaixo.

{
      "retorno": {
         "contratos": [
             {
                 "contrato": {
                     "id": 000001,
                     "numeroContrato": 1234567
                  }
             }
         ]
     }
}

Caso algum problema tenha sido encontrado durante o processamento do XML enviado, os códigos de retorno serão conforme a tabela de erros.