Criar uma saída de armazém

Através deste EndPoint, você pode criar os seguintes tipos de saídas de armazém:

Saída por uma OS: quando a saída é gerada a partir dos recursos solicitados em uma requisição de material gerada por uma OS. Para realizar isto, é obrigatório ter as informações do armazém, a requisição, a OS e que a requisição tenha entregas pendentes. Caso algum dos itens da requisição seja gerenciado por série, deve-se enviar o parâmetro "items" (array) com todas as informações dos itens que farão parte da saída.
Tipo geral: são associadas as peças de reposição que se deseja descontar do armazém. Para realizar isto, é obrigatório ter as informações do armazém, a referência da transação, enviar o tipo de movimento e o array de itens que se deseja associar.
Tipo transferência de armazém: deve-se indicar o armazém destino da transferência e o array de itens que se deseja associar.
Tipo devolução ao fornecedor: pode-se indicar o fornecedor (é opcional) e os artigos que estarão envolvidos na transferência.

A informação opcional que pode ser adicionada à saída é o código ou descrição do centro de custo e as notas da saída de armazém.

Parâmetros do Body

A seguinte informação deve ser enviada no body da solicitação.

Parâmetro	Tipo	Obrigatório	Descrição
`warehouse_code`	Texto	Sim	Código do Armazém. Pode ser consultado aqui. (campo code)
`wo_folio`	Texto	Sim (somente para saídas tipo OS)	Id da ordem de serviço que tem a requisição associada. Pode ser consultado aqui. (campo folio)
`id_movement`	Texto	Sim (somente para saídas tipo OS)	Id da requisição de material. Pode ser consultado aqui (campo folio_source)
`id_movement_type`	Número	Sim	Tipo de saída a realizar: 4: Saída por OS (valor padrão) 5: Saída Geral 6: Devolução ao fornecedor 8: Saída por transferência
`responsible_code`	Texto	Sim	Código do recurso humano responsável pela saída de armazém. Deve ser um recurso humano existente no Fracttal. Pode ser consultado aqui. (campo code)
`document`	Texto	Sim (Para saídas tipo Geral)	Referência da transação.
`items`	Array de objetos json	Sim (Exceto para saídas por OS onde se deseja a entrega total da requisição ou para requisições que contêm itens controlados por série)	Array de Json, com as informações dos itens que se deseja associar à saída. Os valores que deve ter cada item são: { "code":string, "id_type_item": int, "qty": real, "serial_numbers": array de textos } "code" é o código do item. Pode ser consultado aqui. (campo code) "id_type_item", é o tipo de ativo. Pode ser: 3: Ferramentas 4: Peça de reposição e suprimento "serial_numbers", aplica-se somente aos itens controlados por série
`date`	Texto	Opcional	Data de entrega. Por padrão é a data atual em UTC-0
`description`	Texto	Opcional	Notas da saída de armazém
`description_cost_center`	Texto	Opcional	Descrição do centro de custos. Deve existir no Fracttal
`value_cost_center`	Texto	Opcional	Valor do centro de custos. Deve existir no Fracttal. Só é necessário enviar um dos 2: o description_cost_center ou o value_cost_center.
`target_warehouse_code`	Texto	Sim (Para saídas tipo transferência)	Código de armazém destino. Pode ser consultado aqui. (campo code)
`code_supplier`	Texto	Opcional	Código do fornecedor (terceiro). Pode ser consultado aqui. (campo code)

Parâmetros de saída

Parâmetro	Tipo	Descrição
`id_movement_type`	Número	Id do tipo de movimento
`id_warehouse_source`	Número	id do armazém origem do movimento
`id_warehouse_target`	Número	id do armazém destino do movimento
`date`	Data	Data do movimento de saída
`description`	Texto	Descrição do movimento de saída
`document`	Texto	Referência do movimento de saída
`responsible_code`	Texto	Usuário responsável pelo movimento de saída
`items`	Array de objetos json	Informação dos itens que foram associados à saída e aos quais foi realizada a entrega total

Detalhes dos objetos items

Parâmetro	Tipo	Descrição
`id_movement`	Texto	Id do movimento
`qty`	Texto	Quantidade em movimento
`unit_cost`	Texto	Custo unitário
`total_cost`	Texto	Custo total
`items_description`	Texto	Descrição do item em movimento

Exemplos

Exemplo saída por OS (entrega total de requisição)

Solicitação: (POST)https://app.fracttal.com/api/warehouse_outputs_orders/

{    
    "id_movement_type": 4,
    "warehouse_code": "JCD-HERR-001",
    "responsible_code": "JCDIAZG",
    "wo_folio": "OT-25484",
    "id_movement": "40"
}

Exemplo saída por OS parcial (itens seriados)

Solicitação: (POST)https://app.fracttal.com/api/warehouse_outputs_orders/

{  
   "warehouse_code":"BD_SERIAL",
   "wo_folio":"OT-1737",
   "id_movement":"25",
   "responsible_code":"AP87757",
   "description":"Saída de armazém mediante API",
   "items":[
       {
           "code":"CLL0976",
           "id_type_item":4,
           "qty":2,
           "serial_numbers":["85564","98756"]           
       }
    ]   
}

Exemplo saída geral

Solicitação: (POST)https://app.fracttal.com/api/warehouse_outputs_orders/

{
    "warehouse_code": "ALM-RUBEN",
    "id_movement_type": "5",
    "responsible_code": "RH-002",
    "document": "SALIDA-001",
    "items": [
        {
            "code": "PPC.TH.AR2.346",
            "id_type_item": 4,
            "qty": 1
        }
    ]
}

Exemplo saída por transferência

Solicitação: (POST)https://app.fracttal.com/api/warehouse_outputs_orders/

{    
    "id_movement_type": 8,
    "warehouse_code": "JCD-HERR-001",
    "target_warehouse_code": "AAA-001",
    "responsible_code": "JCDIAZG",
    "document": "D-0001", 
    "items": [
        {
            "code": "JCD-H-0001",
            "id_type_item": 3,
            "qty": 1         
        }
    ]
}

Exemplo saída por devolução ao fornecedor

Solicitação: (POST)https://app.fracttal.com/api/warehouse_outputs_orders/

{    
    "id_movement_type": 6,
    "warehouse_code": "JCD-HERR-001",
    "responsible_code": "JCDIAZG",
    "document": "D-0001",    
    "code_supplier": "TRD-MRX-001",
    "items": [
        {
            "code": "JCD-H-0001",
            "id_type_item": 3,
            "qty": 1         
        }
    ]
}

TESTE DE CONEXÃO