Ejemplos - Creación de Folio

Este documento contiene solo ejemplos prácticos del endpoint de creación de folios. Aquí puedes ver cómo enviar la información desde distintos lenguajes.

Este archivo complementa la documentación principal Creación de folio.

---

Ejemplo 1: Creación de folio con archivo PDF (cURL)

curl -X POST https://www.sandboxadmin.firmaris.co/api/integrations/sign \
  -H "x-api-key: Bearer TU_TOKEN_DE_EMPRESA" \
  -F 'signers=[{"name":"Juan Pérez","email":"juan@correo.com","documentType":"CC","documentNumber":"123456789","cellPhoneNumber":"3001234567"}]' \
  -F "folioName=Contrato de Servicios" \
  -F "folioMessage=Por favor firme el contrato adjunto" \
  -F "signatureType=1" \
  -F "urlReturn=https://miempresa.com/callback" \
  -F "fileType=file" \
  -F "sendEmail=true" \
  -F "documents[]=@contrato.pdf"

---

Ejemplo 2: Creación de folio con archivo PDF (JavaScript - fetch)

const formData = new FormData();

formData.append(
  'signers',
  JSON.stringify([
    {
      name: 'Juan Pérez',
      email: 'juan@correo.com',
      documentType: 'CC',
      documentNumber: '123456789',
      cellPhoneNumber: '3001234567'
    }
  ])
);

formData.append('folioName', 'Contrato de Servicios');
formData.append('folioMessage', 'Por favor firme el contrato adjunto');
formData.append('signatureType', '1');
formData.append('urlReturn', 'https://miempresa.com/callback');
formData.append('fileType', 'file');
formData.append('sendEmail', 'true');
formData.append('documents[]', fileInput.files[0]);

fetch('https://www.sandboxadmin.firmaris.co/api/integrations/sign', {
  method: 'POST',
  headers: {
    'x-api-key': 'Bearer TU_TOKEN_DE_EMPRESA'
  },
  body: formData
})
.then(res => res.json())
.then(data => console.log(data));

---

Ejemplo 3: Creación de folio con archivo PDF (PHP - cURL)

$ch = curl_init();

$data = [
  'signers' => json_encode([
    [
      'name' => 'Juan Pérez',
      'email' => 'juan@correo.com',
      'documentType' => 'CC',
      'documentNumber' => '123456789',
      'cellPhoneNumber' => '3001234567'
    ]
  ]),
  'folioName' => 'Contrato de Servicios',
  'folioMessage' => 'Por favor firme el contrato adjunto',
  'signatureType' => '1',
  'urlReturn' => 'https://miempresa.com/callback',
  'fileType' => 'file',
  'sendEmail' => 'true',
  'documents[]' => new CURLFile('contrato.pdf')
];

curl_setopt_array($ch, [
  CURLOPT_URL => 'https://www.sandboxadmin.firmaris.co/api/integrations/sign',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'x-api-key: Bearer TU_TOKEN_DE_EMPRESA'
  ],
  CURLOPT_POSTFIELDS => $data
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

---

Ejemplo 4: Creación de folio usando documentos en Base64 (cURL)

curl -X POST https://www.sandboxadmin.firmaris.co/api/integrations/sign \
  -H "x-api-key: Bearer TU_TOKEN_DE_EMPRESA" \
  -F 'signers=[{"name":"Ana Gómez","email":"ana@correo.com","documentType":"CC","documentNumber":"987654321","cellPhoneNumber":"3009876543"}]' \
  -F "folioName=Contrato Laboral" \
  -F "folioMessage=Por favor firme el contrato laboral" \
  -F "signatureType=2" \
  -F "urlReturn=https://miempresa.com/webhook" \
  -F "fileType=base64" \
  -F "sendEmail=true" \
  -F 'documentsBase64=[{"name":"contrato.pdf","content":"JVBERi0xLjQKJ..."}]'

---

Nota final

• Estos ejemplos están pensados para Sandbox
• En producción la URL puede cambiar
• Los valores son solo demostrativos
• El token debe mantenerse seguro