Criar uma entrada em um armazém

Endpoint

POST https://app.fracttal.com/api/warehouse_entries_orders/{warehouse_code}

Parâmetro de URL

Parâmetro	Tipo	Obrigatório	Descrição
`warehouse_code`	Texto	Sim	Código do armazém no qual a entrada será criada. Pode ser consultado em Consultar armazéns, campo `code`.

Tipos de entrada

Você pode criar entradas por compra ou por devolução.

Entrada por compra

Compra nova: envie todos os recursos que entrarão no armazém com suas respectivas quantidades e preços. Para esse tipo de entrada, os recursos recebem por padrão o imposto que a empresa definiu como padrão.
Compra a partir de uma ordem de compra: envie a identificação da ordem de compra criada no armazém. Você pode criar uma entrada total ou parcial dos recursos associados à ordem de compra selecionada. Para uma entrada parcial, envie o array items com o código e a quantidade de cada item. Para uma entrada total, não é necessário enviar items.

Entrada por devolução

Use este tipo de entrada quando materiais entregues por uma saída de armazém forem devolvidos.

Para criar a entrada, envie a identificação da saída criada no armazém. Você pode criar uma entrada total ou parcial dos recursos associados à saída. Para uma entrada parcial, envie o array items com o código e a quantidade de cada item. Para uma entrada total, não é necessário enviar items.

Requisitos

Envie em code_user o código de um recurso humano responsável pela transação.
Verifique se o usuário associado a code_user possui uma conta criada na Fracttal.
Quando a entrada estiver relacionada a movimentos dentro do armazém, o fornecedor, o centro de custo e a moeda serão atribuídos automaticamente a partir do movimento de origem, seja uma ordem de compra ou uma saída. Se precisar modificar esses dados, envie os parâmetros correspondentes no body da solicitação.

Parâmetros do body

Envie as seguintes informações no body da solicitação.

Parâmetro	Tipo	Obrigatório	Descrição
`movement_type`	Número	Sim	Tipo de movimento. `1` = Compra `2` = Devolução
`is_from_movement`	Booleano	Opcional	Use `true` para criar uma entrada a partir de um movimento existente na Fracttal, como uma ordem de compra ou uma saída. Use `false` para criar uma nova entrada informando manualmente os itens. Valor padrão: `false`.
`document`	Texto	Sim	Referência da entrada. Para ordem de compra, envie o `folio_target` da ordem de compra. Pode ser consultado em Consulta de ordem de compra. Para devolução, envie o `document` da saída. Pode ser consultado em Consulta movimentos de saída. Se a entrada não vier de um movimento, envie um valor de livre escolha.
`code_user`	Texto	Sim	Código do usuário associado ao recurso humano responsável pela transação. Pode ser consultado em Consulta de recursos humanos, campo `code`.
`code_supplier`	Texto	Opcional	Código do terceiro classificado como fornecedor. Pode ser consultado em Consulta de terceiros, campo `code`.
`value_cost_center`	Texto	Opcional	Código do centro de custo. Não é necessário enviá-lo se `description_cost_center` for enviado. Pode ser consultado em Consultar centros de custo, campo `value`.
`description_cost_center`	Texto	Opcional	Descrição do centro de custo. Não é necessário enviá-la se `value_cost_center` for enviado. Pode ser consultada em Consultar centros de custo, campo `description`.
`note`	Texto	Opcional	Notas da entrada.
`items`	Array de objetos JSON	Sim para entradas novas ou parciais	Lista de recursos que serão adicionados à entrada. Em entradas totais a partir de uma ordem de compra ou de uma saída, não é necessário enviar este array.

Objetos de `items`

Parâmetro	Tipo	Obrigatório	Descrição
`code`	Texto	Sim	Código do recurso que será adicionado à entrada. O recurso deve estar associado ao armazém.
`qty`	Texto	Sim	Quantidade do recurso.
`unit_cost`	Número real	Sim	Custo unitário.
`tax_name`	Texto	Opcional	Nome do imposto. Se não for enviado, será associado o imposto padrão da empresa.
`serial_numbers`	Array de strings	Opcional	Envie este campo somente quando o recurso for controlado por número de série. A quantidade de números de série deve ser igual à quantidade de recursos informada em `qty`.

Exemplo: entrada parcial por devolução

{
  "movement_type": "2",
  "is_from_movement": true,
  "code_user": "25198772-2",
  "document": "784",
  "note": "Entrada a partir de uma saída por integração",
  "items": [
    {
      "code": "HERRA01",
      "qty": "1"
    }
  ]
}

Parâmetros de saída

Parâmetro	Tipo	Descrição
`folio_target`	Inteiro	ID do movimento.
`date`	Data	Data da entrada.
`description`	Texto	Nota da entrada.
`document`	Texto	Referência.
`id_third_party`	Texto	ID do terceiro.
`third_parties_name`	Texto	Nome do terceiro.
`third_parties_code`	Texto	Código do terceiro.
`id_cost_center`	Texto	ID do centro de custo.
`costs_center_value`	Texto	Valor do centro de custo.
`costs_center_description`	Texto	Descrição do centro de custo.
`folio_source`	Texto	ID do movimento de origem do armazém.
`date_create`	Texto	Data de criação do movimento.
`id_priority`	Texto	ID da prioridade.
`priorities_description`	Texto	Prioridade.
`id_currency`	Número	ID da moeda.
`currency_description`	Texto	Descrição da moeda.
`currency_symbol`	Texto	Símbolo da moeda.
`movements_states_description`	Texto	Descrição do estado do movimento.
`movement_details`	Array JSON	Lista de itens associados à entrada.

Exemplo 1: nova entrada sem movimentos associados

Requisição

POST https://app.fracttal.com/api/warehouse_entries_orders/002

{
  "movement_type": "1",
  "code_user": "25198772-2",
  "code_supplier": "terc-00123e3",
  "value_cost_center": "500000000",
  "document": "In_7456",
  "note": "Entrada por integração",
  "items": [
    {
      "code": "AFL_056",
      "qty": "5",
      "unit_cost": "135",
      "serial_numbers": ["A5402", "A5403", "A5404", "A5405", "A5406"]
    },
    {
      "code": "4890255A-R1",
      "qty": "20",
      "unit_cost": "750"
    },
    {
      "code": "MMRVH6900",
      "qty": "8",
      "unit_cost": "42533"
    },
    {
      "code": "38079",
      "qty": "50",
      "unit_cost": "5794"
    }
  ]
}

Resposta

{
  "success": true,
  "message": "200",
  "data": {
    "id": 3977,
    "folio_target": "MOV206ANTO",
    "date": "2019-10-18",
    "description": "Entrada por integração",
    "document": "In_7456",
    "id_third_party": 2062,
    "third_parties_name": "adecco",
    "third_parties_code": "terc-00123e3",
    "id_cost_center": 421,
    "costs_center_description": "Fracttal 2019",
    "costs_center_value": "500000000",
    "folio_source": null,
    "date_create": "2019-10-18T17:13:50.008899+00:00",
    "id_priority": null,
    "priorities_description": null,
    "id_currency": 7,
    "currency_description": "PESO CHILENO",
    "currency_symbol": "$",
    "movements_states_description": "IN",
    "movement_details": [
      {
        "id_item": 5075,
        "items_description": "ACEITE VALVOLINE EURO  15W40 { 38079 } VALVOLINE",
        "code": "38079",
        "units_description": "LITROS",
        "qty": 50,
        "unit_cost": 5794,
        "total_cost": 344743,
        "tax_name": "IVA",
        "tax_rate": 19
      },
      {
        "id_item": 12437,
        "items_description": " FILTRO DE  MALLA HAGIE 690629 MMRVH6900  HYUNDAI { MMRVH6900 }",
        "code": "MMRVH6900",
        "units_description": "UNIDAD",
        "qty": 8,
        "unit_cost": 42533,
        "total_cost": 404914,
        "tax_name": "IVA",
        "tax_rate": 19
      },
      {
        "id_item": 5470,
        "items_description": "CORONA Y PIÑON EJE CORTO KIT 11X38 MFSerie 300 11X38 Fabricante { 4890255A-R1 }",
        "code": "4890255A-R1",
        "units_description": "UNIDAD",
        "qty": 20,
        "unit_cost": 750,
        "total_cost": 17850,
        "tax_name": "IVA",
        "tax_rate": 19
      },
      {
        "id_item": 122,
        "items_description": "AFLOJATODO  ACOMPA015 { AFL_056 } LUBRITEX S.A",
        "code": "AFL_056",
        "units_description": "Maquina",
        "qty": 5,
        "unit_cost": 135,
        "total_cost": 803.25,
        "tax_name": "IVA",
        "tax_rate": 19
      }
    ]
  },
  "total": 1
}

Exemplo 2: nova entrada a partir de uma ordem de compra