---
title: "MySign | Integração por API"
description: "Integre o MySign ao seu ERP, CRM ou portal: crie documentos, adicione signatários, consulte status e receba cada evento por webhook assinado, com ambiente de sandbox."
canonical_url: "https://jrsistemas.net/mysign/integracao"
meta:
  "og:description": "Integre o MySign ao seu ERP, CRM ou portal: crie documentos, adicione signatários, consulte status e receba cada evento por webhook assinado, com ambiente de sandbox."
  "og:image": "https://jrsistemas.net/uploads/12b0938d-73e5-4bba-b8a6-7734c87c96d9.png"
  "og:title": "Integração por API"
---

> Index of every page on this site: [llms.txt](https://jrsistemas.net/llms.txt)

# API RESTful e webhooks assinados

Integre o MySign ao seu ERP, CRM ou portal e deixe a assinatura dentro do seu produto.

## **Ida e volta: você cria, o MySign avisa**

O seu sistema cria o documento e cadastra os signatários por uma chamada; o MySign devolve cada evento por webhook, com assinatura para validar a origem.

- Autenticação por token com escopo
- Webhooks para cada mudança de status
- Ambiente de sandbox para homologar

[Pedir acesso à API](https://jrsistemas.net/contato) [Referência da API](https://jrsistemas.net/mysign/docs/api)

Seu sistemaPOST /documents{ signers: \[...] }201 doc\_8f2cMySign

document.createdsigner.signeddocument.completedAPI RESTwebhooks assinados

## **Quatro passos até produção**

1. 01 ### **Token com escopo**

   Gere uma chave no painel, limitada às ações que o seu sistema precisa.
2. 02 ### **Crie o documento**

   Um POST com o PDF, os signatários e o nível de cada um. A resposta traz o id e o status.
3. 03 ### **Receba os eventos**

   Cada mudança de status chega no seu endpoint, assinada para você validar a origem.
4. 04 ### **Homologue no sandbox**

   Teste o fluxo inteiro sem gastar documentos reais; depois troque a chave e publique.

[Quero uma chave de sandbox](https://jrsistemas.net/contato)

## **Um documento em uma chamada**

PDF, signatários e nível de cada um numa requisição. A resposta traz o id do documento e o status inicial; o resto chega por webhook.

- JSON simples, sem SDK obrigatório
- Níveis por signatário na mesma chamada
- Webhook por documento ou global

[Ver todos os endpoints](https://jrsistemas.net/mysign/docs/api)

```
POST /api/v1/documents
{
  "name": "Contrato de prestação",
  "file": "<base64>",
  "signers": [
    { "name": "Maria", "email": "maria@acme.com", "level": "advanced" }
  ],
  "webhook": "https://acme.com/mysign/events"
}

201 { "id": "doc_8f2c", "status": "waiting" }
```

## **Os eventos que chegam no seu endpoint**

### **document.created**

O documento foi criado e está aguardando envio ou assinaturas.

### **signer.opened**

Um signatário abriu o link do documento.

### **signer.signed**

Um signatário assinou; o evento traz o nível e o horário.

### **document.completed**

Todos assinaram; o PDF final com certificado está disponível.

[Integrar o MySign ao meu sistema](https://jrsistemas.net/contato)

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://jrsistemas.net/#website","@type":"WebSite","description":"Desde 2003 desenvolvendo software de gestão. O PowerP é a base; sobre ele, gestão educacional, gestão de atendimento, assinatura digital e gateway de NFS-e.","inLanguage":"pt-BR","name":"JR Sistemas","url":"https://jrsistemas.net/","publisher":{"@id":"https://jrsistemas.net/#identity"},"workTranslation":[{"@id":"https://jrsistemas.net/#website"},{"@id":"https://jrsistemas.net/#website"}]},{"@id":"https://jrsistemas.net/mysign/integracao#webpage","@type":"WebPage","description":"Assine documentos em minutos com certificado A1 ICP-Brasil, trilha de auditoria e integração por API. Planos para qualquer volume.","name":"Integração por API","url":"https://jrsistemas.net/mysign/integracao","isPartOf":{"@id":"https://jrsistemas.net/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://jrsistemas.net/mysign/integracao"]}],"primaryImageOfPage":{"@id":"https://jrsistemas.net/#logo"}},{"@id":"https://jrsistemas.net/#identity","@type":"Organization","email":"comercial@jrsistemas.net","name":"JR Sistemas e Tecnologia LTDA","telephone":"(38) 2100-9600","url":"https://jrsistemas.net","logo":{"@id":"https://jrsistemas.net/#logo"}},{"@id":"https://jrsistemas.net/#logo","@type":"ImageObject","caption":"JR Sistemas e Tecnologia LTDA","contentUrl":"https://jrsistemas.net/logos/jrsistemas.png","inLanguage":"pt-BR","url":"https://jrsistemas.net/logos/jrsistemas.png"}]}
```

## Sitemap

See the full [sitemap](https://jrsistemas.net/sitemap.md) for all pages.