Documentação para utilização da API – V2 para integração do sistema Dautin.
\nPara utilizar o ambiente de teste as requisições devem ser feitas no domínio \"dautin.io\" ao invés de \"dautin.com\", cadastre-se em \"dautin.io/Account/Register\" ou solicite uma conta com o nosso suporte (suporte@dautin.com).
\nAutenticação do tipo \"Bearer Token\" realizada através de um token de acesso, solicitado na chamada (/token).
\nApós gerado o token, todas as solicitações devem conter o número deste token no header da requisição para que seja possível realizar as chamadas.
\nO tempo de expiração do token é de 3 meses, mas a Dautin se reserva no direito de ajustar o vencimento, caso necessário.
\n200: Sucesso;
\n700: Token não encontrado;
\n706: Nuvem de armazenamento não pôde ser inicializada;
\n708: Erro no armazenamento em nuvem do arquivo final;
\n715: Transação não existe ou não foi encontrada;
\n719: Acesso Negado;
\n721: Arquivo Não Armazenado;
\n800: Sem conteúdo no 'body';
\n801: Parâmetros passados incorretamente;
\n802: Um ou mais parâmetros estão nulos ou vazios;
\n803: Usuário conta PJ sem plano ativo;
\n804: O tamanho dos arquivos combinados ultrapassa o limite de 100MB;
\n805: O usuário não possui espaço suficiente na conta para armazenar;
\n810: Não foi possível realizar download de um ou mais arquivos;
\n811: Não foi possível converter um ou mais arquivos em PDF;
\n812: Não foi possível baixar o PDF convertido de um ou mais arquivos;
\n813: Não foi possível unificar os arquivos em um único PDF;
\n814: Não foi possível cancelar a operação;
\n815: Não foi possível baixar o JPG convertido de um ou mais arquivos;
\n816: Não foi possível buscar a lista de signatários;
\n817: Não foi possível gerar o arquivo timbrado;
\n1: Aguardando Pagamento;
\n2: Processando Pagamento;
\n3: Pendente;
\n4: Falha;
\n5: Não Realizada;
\n6: Processando Reembolso;
\n7: Sucesso;
\n8: Aguardando Assinatura;
\n9: Aguardando Usuário;
\n10: Aguardando Blockchain;
\n11: Aguardando API (ação do usuário);
\nRetorno em JSON:
\n{\n status: {codigo_retorno},\n data: {info_adicional}\n}\nE-mail do usuário no sistema Dautin (Obrigatório)
\n","key":"username","type":"text","value":"Torey.Veum@gmail.com"},{"description":"Chave de API fornecida pela Dautin (Obrigatório)
\n","key":"password","type":"text","value":"LjAoXdQbyL6g6CR"},{"description":"Preencher por padrão com 'password' (Obrigatório)
\n","key":"grant_type","type":"text","value":"password"},{"description":"Identificador do solicitante (Obrigatório)
\n","key":"requester","type":"text","value":"Kunze, Rowe and Huels"}]},"url":"https://www.dautin.com/token","description":"Método para geração de token do usuário.
\n{ \n access_token: {token},\n token_type: bearer,\n expires_in: 2147483647\n}\nOnde {token} é o código retornado pelo sistema.
\n{ \n error: invalid_grant,\n error_description: {codigo_erro}\n}\nOnde o {codigo_erro} pode ser:
\n11: Usuário não encontrado;
\n12: Senha incorreta;
\n13: Chave de API inválida.
\n","urlObject":{"protocol":"https","path":["token"],"host":["www","dautin","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"50ff2f2c-2548-4643-9bfc-6f5fbcb8d074"},{"name":"Cancelar Token","id":"e6384c81-a7be-4fa1-b736-db98badc213b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","description":"Preencher por padrão com 'application/x-www-form-urlencoded' (Obrigatório)
\n","type":"text"},{"key":"Authorization","value":"Bearer {codigo_token}","description":"Substituir {codigo_token} pelo token do usuário gerado em '/token' (Obrigatório)
\n","type":"text"}],"url":"https://www.dautin.com/api/v2/CancelToken","description":"Método para cancelar um token ativo.
\n{\n status: 200, \n data: null\n}\n{\n status: 700, \n data: null \n}\nPreencher por padrão com 'application/json' (Obrigatório)
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"Substituir {codigo_token} pelo token do usuário gerado em '/token' (Obrigatório)
\n","key":"Authorization","type":"text","value":"Bearer {codigo_token}"}],"body":{"mode":"raw","raw":"{\r\n \"filesUrl\":[\r\n \"https://christophe.org\",\r\n \"http://asia.net\",\r\n \"http://willis.name\"\r\n ],\r\n \"filesExt\":[\r\n \"pdf\",\r\n \"docx\",\r\n \"png\"\r\n ],\r\n \"labelName\": \"Contrato de Compra e Venda\",\r\n \"cancelationUrl\": \"http://cancel_url.com\",\r\n \"successUrl\": \"http://success_url.com\",\r\n \"signatureDate\": \"30/12/2020\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://www.dautin.com/api/v2/Contract","description":"Método para gerar um registro de contrato.
\n1. Nos valores de \"filesExt\" passar as extensões na ordem correspondente aos arquivos passados em \"filesUrl\";
\n2. Nos valores de \"filesExt\" passar as extensões sem o ponto (.), ex: 'pdf' ao invés de '.pdf';
\n3. A data de assinatura deve estar no padrão dd/MM/yyyy e sendo no mínimo o dia atual e no máximo 45 dias contando do dia atual;
\n4. A URL de cancelamento (cancelationUrl) será chamada em nosso sistema quando a operação for cancelada pelo usuário, quando houver recusa de contrato ou houver falha no registro no blockchain;
\n5. A URL de sucesso (successUrl) será chamada em nosso sistema quando a operação for registrada e concluída com sucesso;
\n6. Tanto para a URL de cancelamento ou de sucesso, a chamada será feita via POST repassando via 'body' em JSON os parâmetros conforme o formato abaixo:
\n{\n Id: {id_transacao},\n Status: {codigo_tx_status}\n}\n7. A operação fica pendente para conclusão dentro do sistema por um prazo de até 24 horas, após isso ela será cancelada automaticamente.
\n{\n status: 200, \n data: {id_transacao}\n}\nOnde {id_transacao} é o código da transação gerada dentro do sistema.
\nUtilizar a URL https://www.dautin.com/ws/Contract/{id_transacao} para navegar até a tela onde o usuário vai realizar o processo para concluir a operação.
\n{\n status: 700/706/708/719/800/801/802/803/804/805/810/811/812/813, \n data: {info} ou null \n}\nUma mensagem adicional no campo {info} detalhando o que ocorreu estará disponível para os retornos: 706/708/801/802/804/805/810/811/812/813.
\n","urlObject":{"protocol":"https","path":["api","v2","Contract"],"host":["www","dautin","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0feab4bb-51a5-45ad-a34d-8c885df04b46"},{"name":"Consultar Transação","id":"9c1bf0dc-9e38-4042-9d6a-98fd5ae8e80b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Preencher por padrão com 'application/x-www-form-urlencoded' (Obrigatório)
\n","key":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"description":"Substituir {codigo_token} pelo token do usuário gerado em '/token' (Obrigatório)
\n","key":"Authorization","type":"text","value":"Bearer {codigo_token}"}],"url":"https://www.dautin.com/api/v2/Verify?id=906","description":"Método para verificar uma operação.
\n{\n status: 200, \n data:\n {\n /* Apenas para Contratos */\n int QtySignatories;\n int QtyConfirmations;\n bool NeedSignature;\n /* Apenas para Contratos */\n \n int Id;\n string LabelName;\n string TxStatus:\n string TxStatusDescription;\n string FileExtension;\n string FileSize; \n string AccessType;\n string IsStored;\n string HashCode;\n string TxCode;\n string TxLink;\n string SignatureHierarchy;\n string Subject; \n string DocumentaryType; \n DateTime CreatedAt;\n DateTime UpdatedAt;\n DateTime? ApprovedAt;\n DateTime? BxTimestamp;\n }\n}\n{\n status: 700/715, \n data: null \n}\nId da transação que deseja consultar (Obrigatório)
\n","type":"text/plain"},"key":"id","value":"888"}],"variable":[]}},"response":[],"_postman_id":"9c1bf0dc-9e38-4042-9d6a-98fd5ae8e80b"},{"name":"Cancelar Transação","id":"3eb3da02-75e4-4b4e-a95d-07b4badf6738","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Preencher por padrão com 'application/x-www-form-urlencoded' (Obrigatório)
\n","key":"Content-Type","type":"text","value":"application/x-www-form-urlencoded"},{"description":"Substituir {codigo_token} pelo token do usuário gerado em '/token' (Obrigatório)
\n","key":"Authorization","type":"text","value":"Bearer {codigo_token}"}],"url":"https://www.dautin.com/api/v2/Cancel?Id=240","description":"Método para cancelar uma operação. Atentar para o fato de que apenas contratos com status: (1) aguardando pagamento, (8) aguardando assinatura ou (11) aguardando API; podem ser cancelados
\n{\n status: 200, \n data: {status_transacao}\n}\nOnde {status_transacao} é o status atual da transação dentro do sistema.
\n{\n status: 700/715/719/814, \n data: null \n}\nId da transação que deseja consultar (Obrigatório)
\n","type":"text/plain"},"key":"Id","value":"750"}],"variable":[]}},"response":[],"_postman_id":"3eb3da02-75e4-4b4e-a95d-07b4badf6738"},{"name":"Download Arquivo Timbrado","id":"28b21ea8-70df-464b-9924-05b08ffe3a07","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","description":"Preencher por padrão com 'application/x-www-form-urlencoded' (Obrigatório)
\n","type":"text"},{"key":"Authorization","value":"Bearer {codigo_token}","description":"Substituir {codigo_token} pelo token do usuário gerado em '/token' (Obrigatório)
\n","type":"text"}],"url":"https://www.dautin.com/api/v2/DownloadStampedFile?Id=827","description":"Método para fazer download de um arquivo timbrado de uma operação finalizada com status (7) sucesso.
\n{\n status: 200, \n data: {url_arquivo}\n}\nOnde {url_arquivo} é a URL de acesso ao arquivo timbrado, válida por 5 minutos.
\n{\n status: 700/706/708/715/719/721/810/811/815/816/817, \n data: {info} ou null \n}\nUma mensagem adicional no campo {info} detalhando o que ocorreu estará disponível para os retornos: 708/810/811/815/816/817.
\n","urlObject":{"protocol":"https","path":["api","v2","DownloadStampedFile"],"host":["www","dautin","com"],"query":[{"description":{"content":"Id da transação que deseja consultar (Obrigatório)
\n","type":"text/plain"},"key":"Id","value":"533"}],"variable":[]}},"response":[],"_postman_id":"28b21ea8-70df-464b-9924-05b08ffe3a07"},{"name":"Download Certificado","id":"8db29a1b-8a81-42ba-826d-2442ab13516f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","description":"Preencher por padrão com 'application/x-www-form-urlencoded' (Obrigatório)
\n","type":"text"},{"key":"Authorization","value":"Bearer {codigo_token}","description":"Substituir {codigo_token} pelo token do usuário gerado em '/token' (Obrigatório)
\n","type":"text"}],"url":"https://www.dautin.com/api/v2/DownloadCertificate?Id=380","description":"Método para fazer download do certificado de uma operação finalizada com status (7) sucesso.
\n{\n status: 200, \n data: {url_arquivo}\n}\nOnde {url_arquivo} é a URL de acesso ao arquivo timbrado, válida por 5 minutos.
\n{\n status: 700/706/715, \n data: null \n}\nId da transação que deseja consultar (Obrigatório)
\n","type":"text/plain"},"key":"Id","value":"561"}],"variable":[]}},"response":[],"_postman_id":"8db29a1b-8a81-42ba-826d-2442ab13516f"}],"event":[{"listen":"prerequest","script":{"id":"ea06f0e8-f40f-42c0-b0d6-d71620719c7e","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"24379fb5-b79f-48be-9340-77b1fb8fd776","type":"text/javascript","exec":[""]}}],"variable":[{"key":"password","value":"password"}]}