v1

latestOpenAPI 3.0.32026-07-24398641.3 MB

Contacts

contacts__createContact

Crea un contacto (cliente, proveedor, o ambos). Equivale a POST /contacts. Únicamente name es obligatorio para Alegra; los demás campos son opcionales y dependen del país y del flujo del usuario (facturación electrónica, contabilidad, retenciones, etc.). Para facturar en países con DIAN/SUNAT/SAT, normalmente también se requiere identification y type.

post/tools/contacts__createContact

Request body

Example request

{
  "contact": {
    "name": "Acme S.A.S",
    "identification": "900123456",
    "type": [
      "client"
    ],
    "status": "active",
    "email": "facturacion@acme.co",
    "phonePrimary": "+57 1 5550000",
    "phoneSecondary": "+57 1 5550001",
    "mobile": "+57 3001234567",
    "fax": "+57 1 5550002",
    "address": {
      "city": "Bogotá",
      "address": "Calle 100 #20-30"
    },
    "seller": "5",
    "priceList": "1",
    "term": "30",
    "creditLimit": 5000000,
    "accounting": {
      "debtToPay": "22050501",
      "accountReceivable": "13050501"
    },
    "internalContacts": [
      {
        "name": "Juan",
        "lastName": "Pérez",
        "email": "juan.perez@acme.co",
        "mobile": "+57 3001234567",
        "phone": "+57 1 5550000",
        "sendNotifications": "yes"
      }
    ],
    "statementAttached": "no"
  }
}

Response

Contacto creado exitosamente.