Contactos y Cuentas Bancarias

async function createContact(token, orgId, merchantId, contactData) {
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/contacts`,
    {
      firstName: contactData.firstName,
      lastName: contactData.lastName,               // Opcional
      email: contactData.email,                     // Opcional
      phone: contactData.phone,                     // Opcional
      countrySymbol: contactData.countrySymbol,
      documentType: contactData.documentType,       // Opcional
      documentNumber: contactData.documentNumber,   // Opcional (requerido si se provee documentType)
      businessType: 'PERSON',                       // o 'COMPANY'
      type: 'PERSON'                                // PERSON, BUSINESS, GOVERNMENT, NGO, FOREIGN
    },
    {
      headers: { 
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      }
    }
  );
  
  return response.data;
}
 
// Uso - Crear contacto de cliente
const customer = await createContact(token, orgId, merchantId, {
  firstName: 'Juan',
  lastName: 'Pérez',
  countrySymbol: 'CO',
  email: 'cliente@ejemplo.com',
  phone: '+573001234567',
  documentType: 'CED_CIU',
  documentNumber: '1234567890'
});
 
console.log('Contacto creado:', customer.id);

def create_contact(token, org_id, merchant_id, contact_data):
    response = requests.post(
        f'https://api-sandbox.koywe.com/api/v1/organizations/{org_id}/merchants/{merchant_id}/contacts',
        json={
            'firstName': contact_data['first_name'],
            'lastName': contact_data.get('last_name'),        # Opcional
            'email': contact_data.get('email'),               # Opcional
            'phone': contact_data.get('phone'),               # Opcional
            'countrySymbol': contact_data['country'],
            'documentType': contact_data.get('document_type'),    # Opcional
            'documentNumber': contact_data.get('document_number'),# Opcional (requerido si se provee documentType)
            'businessType': 'PERSON',
            'type': 'PERSON'
        },
        headers={
            'Authorization': f'Bearer {token}',
            'Content-Type': 'application/json'
        }
    )
    
    return response.json()
 
# Uso
customer = create_contact(token, org_id, merchant_id, {
    'first_name': 'Juan',
    'last_name': 'Pérez',
    'email': 'cliente@ejemplo.com',
    'phone': '+573001234567',
    'country': 'CO',
    'document_type': 'CED_CIU',
    'document_number': '1234567890'
})

curl -X POST 'https://api-sandbox.koywe.com/api/v1/organizations/TU_ORG_ID/merchants/TU_MERCHANT_ID/contacts' \
  -H 'Authorization: Bearer TU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "firstName": "Juan",
    "lastName": "Pérez",
    "email": "cliente@ejemplo.com",
    "phone": "+573001234567",
    "countrySymbol": "CO",
    "documentType": "CED_CIU",
    "documentNumber": "1234567890",
    "businessType": "PERSON",
    "type": "PERSON"
  }'

async function addBankAccountToContact(token, orgId, merchantId, contactId, bankData) {
  const response = await axios.post(
    `https://api-sandbox.koywe.com/api/v1/organizations/${orgId}/merchants/${merchantId}/contacts/${contactId}/accounts`,
    {
      name: bankData.name,
      kind: 'BANK',
      isDefault: bankData.isDefault,
      countrySymbol: bankData.country,
      currencySymbol: bankData.currency,
      entity: bankData.entity,           // Requerido para CO, CL. Opcional para otros (auto-deducido)
      accountNumber: bankData.accountNumber,
      type: bankData.type,               // Requerido para Colombia: 'SAVINGS' o 'CHECKING'
      rail: bankData.rail                // Opcional: 'BANK' o 'BREB'. Requerido para una llave Bre-B colombiana
    },
    {
      headers: { 
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      }
    }
  );
  
  return response.data;
}
 
// Uso - Colombia (entity requerido)
const bankAccountCO = await addBankAccountToContact(token, orgId, merchantId, 'cnt_abc123', {
  name: 'Bancolombia COP',
  isDefault: true,
  country: 'CO',
  currency: 'COP',
  entity: 'BANCOLOMBIA',     // Requerido para Colombia y Chile
  accountNumber: '1234567890',
  type: 'SAVINGS'            // Requerido para Colombia
});
 
// Uso - Perú (entity auto-deducido del CCI)
const bankAccountPE = await addBankAccountToContact(token, orgId, merchantId, 'cnt_def456', {
  name: 'Peru PEN',
  isDefault: false,
  country: 'PE',
  currency: 'PEN',
  accountNumber: '00219100012345678901'  // CCI de 20 dígitos - código banco auto-deducido
});
 
console.log('Cuenta bancaria agregada:', bankAccountCO.id);

def add_bank_account_to_contact(token, org_id, merchant_id, contact_id, bank_data):
    payload = {
        'name': bank_data['name'],
        'kind': 'BANK',
        'isDefault': bank_data['is_default'],
        'countrySymbol': bank_data['country'],
        'currencySymbol': bank_data['currency'],
        'accountNumber': bank_data['account_number']
    }
 
    # entity requerido para CO, CL; opcional para otros
    if bank_data.get('entity'):
        payload['entity'] = bank_data['entity']
 
    # type requerido para Colombia; opcional para otros países (por defecto VIRTUAL)
    if bank_data.get('type'):
        payload['type'] = bank_data['type']
 
    # rail opcional: 'BANK' o 'BREB'. Requerido para una llave Bre-B colombiana
    if bank_data.get('rail'):
        payload['rail'] = bank_data['rail']
    
    response = requests.post(
        f'https://api-sandbox.koywe.com/api/v1/organizations/{org_id}/merchants/{merchant_id}/contacts/{contact_id}/accounts',
        json=payload,
        headers={
            'Authorization': f'Bearer {token}',
            'Content-Type': 'application/json'
        }
    )
    
    return response.json()
 
# Uso - Colombia (entity requerido)
bank_account_co = add_bank_account_to_contact(token, org_id, merchant_id, 'cnt_abc123', {
    'country': 'CO',
    'currency': 'COP',
    'entity': 'BANCOLOMBIA',      # Requerido para Colombia
    'account_number': '1234567890',
    'type': 'SAVINGS'                # Requerido para Colombia
})
 
# Uso - Chile (entity requerido)
bank_account_cl = add_bank_account_to_contact(token, org_id, merchant_id, 'cnt_ghi789', {
    'country': 'CL',
    'currency': 'CLP',
    'entity': 'BANCO_ESTADO',     # Requerido para Chile
    'account_number': '12345678901'
})

# Colombia - entity (código banco) requerido
curl -X POST 'https://api-sandbox.koywe.com/api/v1/organizations/TU_ORG_ID/merchants/TU_MERCHANT_ID/contacts/cnt_abc123/accounts' \
  -H 'Authorization: Bearer TU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Bancolombia COP",
    "kind": "BANK",
    "isDefault": true,
    "countrySymbol": "CO",
    "currencySymbol": "COP",
    "entity": "BANCOLOMBIA",
    "accountNumber": "1234567890",
    "type": "SAVINGS"
  }'