Saltar al contenido principal

Crear un depósito

POSThttps://carchost.fieldcontrol.com.br/storages-v2

Crea un depósito. Requiere el módulo de control de inventario.

Requiere los headers X-Api-Key, User-Agent y Content-Type: application/json. Límite: 1 solicitud por segundo (más información).

Solicitud​

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Cuerpo de la solicitud

JSON, enviado con el header Content-Type: application/json.

namestringobligatorio

Nombre del depósito. Debe ser único en la cuenta.

Hasta 150 caracteres.

archivedbooleanobligatorio

Archiva el depósito. Un depósito archivado pierde el colaborador responsable.

descriptionstring

Descripción del depósito.

Hasta 2000 caracteres.

employeeobject

Colaborador responsable del depósito.

Campos de employee
idstring o number

Identificador del colaborador. Un valor que no es un identificador de colaborador quita el responsable.

allowItemRequestsboolean

Permite solicitudes de ítems al depósito.

Predeterminado: false.

isTriageboolean

Define el depósito como de clasificación.

Predeterminado: false.

externalobject
Campos de external
idstring

Identificador del depósito en su sistema.

Hasta 100 caracteres.Acepta: null.

Respuestas

  • 201

    Depósito creado.

  • 401

    Clave de API ausente (Missing API Key) o inválida (Invalid API Key). Consulte Autenticación.

  • 403

    Cuenta bloqueada (Account blocked), vencida (Account expired) o con un plan que no permite integración (Account plan not allowed). Consulte Autenticación.

  • 422

    Cuerpo inválido o nombre ya usado en la cuenta (reason: already exists) (resourceValidationErr). Cuenta sin el módulo de control de inventario: resourceNotAllowed.

  • 429

    Se superó el límite de 1 solicitud por segundo. Consulte Límite de solicitudes.

  • 500

    Error inesperado en el servidor.