Sucursales de Contactos

La API de Sucursales de Contactos permite administrar las sucursales (direcciones, teléfonos y datos operativos) asociadas a un Contacto existente (cliente y/o proveedor). Es útil para sincronizar domicilios de entrega, facturación u operaciones desde sistemas externos. La API está accesible desde la interfaz de usuario a través de la sección Configuración > Contactos, Clientes y Proveedores.

URL y Descripción

• URL Descripción (WSDL): https://api.zetasoftware.com/z.apis.asoapcontactossucursalesv1?wsdl
• Servicio (endpoint SOAP): https://api.zetasoftware.com/z.apis.asoapcontactossucursalesv1

---

Método QUERY

Descripción

Devuelve una lista paginada de sucursales de contactos. Los filtros son opcionales; si se omiten, retorna el conjunto correspondiente a la página solicitada.

Filtros (dentro de Data/Filters)

• ContactoCodigo: string — Código del contacto (tal como figura en el WSDL.
• Sucursal: short — Código de sucursal numérico.

Paginación

• Page: int — Número de página a solicitar (1, 2, …).
• IsLastPage: boolean — Indicador en la respuesta de que es la última página.

Resultado (Response/Item)

• ContactoCodigo
• Nombre
• RazonSocial
• RUT
• Sucursal
• Direccion
• Localidad
• DepartamentoCodigo
• Departamento
• ZonaCodigo
• Zona
• Telefono
• PersonaContacto
• Email
• LugarEntrega

Estado de la operación

• Succeed: boolean
• Error/Code: string
• Error/Message: string

---

Método SAVE

Descripción

Crea o actualiza la sucursal de un contacto. La estructura viaja en Data (WSTransactionContactosSucursalesV1Structure).

Datos (Data)

• ContactoCodigo: string (obligatorio)
• SucursalCodigo: short (obligatorio)
• Direccion: string
• Localidad: string
• DepartamentoCodigo: string
• ZonaCodigo: string
• Telefono: string
• PersonaContacto: string
• Email: string
• LugarEntrega: string

Resultado

• Succeed: boolean
• Error/Code: string
• Error/Message: string
• Error/Detail/Item (opcional):
  • Id
  • Tipo
  • Descripcion

---

Método LOAD

Descripción

Recupera una sucursal específica de un contacto.

Filtros

• ContactoCodigo: string
• SucursalCodigo: short

Resultado (Response)

• ContactoCodigo
• SucursalCodigo
• Direccion
• Localidad
• DepartamentoCodigo
• ZonaCodigo
• Telefono
• PersonaContacto
• Email
• LugarEntrega

Estado de la operación

• Succeed: boolean
• Error/Code: string
• Error/Message: string

---

Método DELETE

Descripción

Elimina una sucursal de un contacto.

Filtros

• ContactoCodigo: string
• SucursalCodigo: short

Resultado

• Succeed: boolean
• Error/Code: string
• Error/Message: string
• Error/Detail/Item (opcional):
  • Id
  • Tipo
  • Descripcion

---

Metodología de Uso Esperada

Método LOAD

Úsese para consultas puntuales de una sucursal específica por su código. No está pensado para listados o recorridos.

Método QUERY

Evite lecturas frecuentes registro-a-registro. La práctica recomendada es sincronizar por páginas (usando Page e interpretando IsLastPage) en una ventana controlada y almacenar el resultado en una base local de integración, reduciendo el tráfico hacia la API. Para re-sincronizaciones, combine filtros y paginación.

---

Ejemplos de uso (bloques SOAP abreviados)

QUERY (página 1, por contacto)

<SOAPContactosSucursalesV1.QUERY>
  <Queryin>
    <Connection>...</Connection>
    <Data>
      <Filters>
        <ContactoCodigo>CL-001</ContactoCodigo>
        <Sucursal></Sucursal>
      </Filters>
      <Page>1</Page>
    </Data>
  </Queryin>
</SOAPContactosSucursalesV1.QUERY>

LOAD (una sucursal)

<SOAPContactosSucursalesV1.LOAD>
  <Loadin>
    <Connection>...</Connection>
    <ContactoCodigo>CL-001</ContactoCodigo>
    <SucursalCodigo>1</SucursalCodigo>
  </Loadin>
</SOAPContactosSucursalesV1.LOAD>

SAVE (crear/actualizar)

<SOAPContactosSucursalesV1.SAVE>
  <Savein>
    <Connection>...</Connection>
    <Data>
      <ContactoCodigo>CL-001</ContactoCodigo>
      <SucursalCodigo>1</SucursalCodigo>
      <Direccion>Av. Rivera 1234</Direccion>
      <Localidad>Montevideo</Localidad>
      <DepartamentoCodigo>10</DepartamentoCodigo>
      <ZonaCodigo>C01</ZonaCodigo>
      <Telefono>29000000</Telefono>
      <PersonaContacto>María Pérez</PersonaContacto>
      <Email>logistica@cliente.com</Email>
      <LugarEntrega>Depósito Central</LugarEntrega>
    </Data>
  </Savein>
</SOAPContactosSucursalesV1.SAVE>

DELETE

<SOAPContactosSucursalesV1.DELETE>
  <Deletein>
    <Connection>...</Connection>
    <ContactoCodigo>CL-001</ContactoCodigo>
    <SucursalCodigo>1</SucursalCodigo>
  </Deletein>
</SOAPContactosSucursalesV1.DELETE>

---

Notas

• Los nombres de elementos y tipos reflejan el WSDL, incluyendo el caso particular del filtro ContactoCodigo
• Todos los métodos retornan Succeed y, en caso de error, el bloque Error con Code y Message. SAVE y DELETE pueden incluir Error/Detail/Item para validaciones específicas.